mcp-shopping-list-firestore

A lightweight, Firebase-backed MCP server for management of a grocery list via simple CRUD operations.

Tools

1. list_items – Get all items.
2. upsert_item – Add or update an item (by id if given; generates one if not).
3. remove_item – Delete an item by id.

Item format

{
  "id": "uuid",
  "name": "apples",
  "quantity": "4",
  "created_at": "2025-08-12T14:31:42Z"
}

Configuration

This server is configured using one environment variable

• GOOGLE_CLOUD_PROJECT: Google Cloud Project ID (required)
• FIRESTORE_DATABASE: Firestore database name (required)

Version output

Use --version to print the application version in this format:

mcp-shopping-list-firestore version vX.Y.Z (goX.Y, os/arch)

Run in Streamable HTTP Transport

To run as an MCP HTTP server, use the --http <addr> flag (e.g., --http 8080). If not specified, the server defaults to stdio.

The MCP server can then be accessed at the following endpoint: http://localhost:<port>/mcp