Firestore MCP Server

An MCP (Model Context Protocol) server for interacting with Google Firestore directly. This server provides a clean interface for creating, reading, updating, and deleting Firestore documents through Claude Desktop.

Features

• Create documents in Firestore collections

• Read documents from Firestore collections

• Update existing documents

• Delete documents

• Query documents with filtering, ordering, and limits

• List available collections

Setup

1. Install dependencies:

   npm install

2. Build the project:

   npm run build

3. Configure Claude Desktop: Add the following to your claude_desktop_config.json:

   "firestore-mcp": { "command": "node", "args": [ "/path/to/firestore-mcp/build/index.js" ], "env": { "GOOGLE_CLOUD_PROJECTS": "project-id" } }

   Replace the path in args with the actual path to index.js.

   Define a comma-separated list of project ids in GOOGLE_CLOUD_PROJECTS. Example: google-project-id1,google-project-id2 The first listed project is the default.

   The application expects to find .json credential file(s) in the keys folder for each project. Example: keys/google-project-id1.json, keys/google-project-id2.json Ensure the cloud service account has appropriate permission to interact with Cloud Firestore, e.g. Cloud Datastore Owner or lesser permission(s).

Available Tools

• getDocument: Get a document by ID from a collection

• createDocument: Create a new document in a collection

• updateDocument: Update an existing document

• deleteDocument: Delete a document

• queryDocuments: Query documents with filters, ordering, and limits

• listCollections: List all available collections

Example Usage in Claude Desktop

Here are examples of how to use each tool in Claude Desktop:

Get a Document

Create a Document

Update a Document

Delete a Document

Query Documents

List Collections

Development

• Watch mode: npm run dev