Firestore MCP

🚀 Firestore MCP Server

A Model Context Protocol (MCP) server that interacts directly with Google Firestore. This server provides a clean interface through Claude Desktop to create, read, update, and delete Firestore documents.

✨ Features

• Create documents in Firestore collections.
• Read documents from Firestore collections.
• Update existing documents.
• Delete documents.
• Query documents using filters, sorting, and limits.
• List available collections.

📦 Installation

1. Install Dependencies

npm install

2. Build the Project

npm run build

3. Configure Claude Desktop

Add the following content to 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 project.

The application expects to find a .json credential file for each project in the keys folder. Example: keys/google-project-id1.json, keys/google-project-id2.json Ensure that the cloud service account has appropriate permissions to interact with Cloud Firestore, such as Cloud Datastore Owner or less.

📚 Documentation

Available Tools

• getDocument: Get a document in a collection by ID.
• createDocument: Create a new document in a collection.
• updateDocument: Update an existing document.
• deleteDocument: Delete a document.
• queryDocuments: Query documents using filters, sorting, and limits.
• listCollections: List all available collections.

💻 Usage Examples

Basic Usage

Here are examples of using 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

Change the age of the document with ID "user123" in the "users" collection to 31.

Delete a Document

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

Query Documents

Find all users over 25 years old and sort them by name.

List Collections

List all available Firestore collections.

Development

• Debug Mode: npm run dev