gitskyflux firestore mcp

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.

• 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

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).

• 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

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

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

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

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

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

Find all users over 25 years old, ordered by name

List all available Firestore collections

• Watch mode: npm run dev