Firestore Advanced

The Firestore Advanced MCP Server lets you connect large language models to your Firestore databases, enabling rich, structured interactions across CRUD operations, queries, transactions, and advanced data types. It empowers you to drive automated data workflows and intelligent data access through MCP-compatible clients.

How to use

Use this MCP server to expose Firestore operations to your MCP client. You can perform basic document actions, run complex queries, manage transactions, and work with special data types like GeoPoints and document references. Configure your MCP client to talk to the server either via a remote HTTP endpoint or by running the server locally as a stdio process, and supply the required service account credentials securely.

How to install

Prerequisites you need before installing this MCP server:

• Node.js version 16.x or newer
• A Firebase project with Firestore enabled
• A Firebase service account key in JSON format

How to install

Step 1. Install the server locally or install globally for easy access.

# Via npm globally
npm install -g firestore-advanced-mcp

# Or clone and install locally
git clone https://github.com/diez7lm/firestore-advanced-mcp.git
cd firestore-advanced-mcp
npm install

How to install

Step 2. Prepare your Firebase service account and environment.

# Export the path to your service account JSON file
export SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json"

How to install

Step 3. Run the server using your preferred method.

# Run with npm globally
SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json" firestore-advanced-mcp

# Run with npx
SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json" npx firestore-advanced-mcp

# Run from the cloned directory
SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json" node index.js

How to install

Step 4. Integrate with Claude or your MCP client by pointing it to the server configuration you choose.

# Example CLI configuration for Claude (illustrative; adapt to your client)

Additional sections

Configuration in your client involves providing the MCP with the command, environment, and startup details so Claude can query Firestore. The server supports both HTTP and stdio connection methods; use the method that matches your deployment preference and security posture.

Configuration and security

Environment variables you may need include the path to your service account key. Keep credentials secure and never commit them to source control. Use restricted service account permissions aligned with your application needs.

Examples

Common scenarios include retrieving a single document, creating documents with references to other documents, configuring document TTL, and performing complex queries with multiple filters.

Troubleshooting

If the server fails to start, verify that the SERVICE_ACCOUNT_KEY_PATH points to a valid JSON key and that your Firestore project is correctly configured. Check that the required Node version is installed and that your environment has network access to Firebase services.

Available tools

firestore_get

Retrieve a document by collection and id

firestore_create

Create a new document in a collection

firestore_update

Update an existing document

firestore_delete

Delete a document

firestore_query

Run a filtered query against a collection

firestore_list_collections

List all collections in the Firestore project

firestore_collection_group_query

Query across collection groups

firestore_composite_query

Advanced query with filters and sorting

firestore_count_documents

Count documents without fetching all data

firestore_special_data_types

Handle GeoPoint, document references, and timestamps

firestore_set_ttl

Configure TTL for documents

firestore_transaction

Execute a multi-operation transaction

firestore_batch

Execute batch operations

firestore_field_operations

Atomic field operations like increment and arrayUnion

firestore_full_text_search

Text search within documents