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

Install dependencies:
npm install
Build the project:
npm run build
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

Get the document with ID "user123" from the "users" collection

Create a Document

Create a new document in the "users" collection with the following data:
{
  "name": "John Doe",
  "email": "john@example.com",
  "age": 30
}

Update a Document

Update the document with ID "user123" in the "users" collection to change the age to 31

Delete a Document

Delete the document with ID "user123" from the "users" collection

Query Documents

Find all users over 25 years old, ordered by name

List Collections

List all available Firestore collections

Development

Watch mode: npm run dev