Firestore Advanced MCP

🔥 Firestore Advanced MCP

Advanced MCP (Model Context Protocol) server for Firebase Firestore, allowing large language models like Claude to fully interact with your Firebase databases.

✨ Features

📝 Full Firestore support : CRUD, compound queries, multiple filters
⚡ Advanced operations : Transactions, atomic operations, batch updates
🔄 Special data types : GeoPoint, document references, timestamps
⏱️ TTL Management : Time-To-Live Configuration for Documents
🔍 Smart Missing Index Detection : Automatic instructions to create the necessary indexes
🎯 Advanced search : Queries on collection groups, complex filters

📋 Prerequisites

Node.js >= 16.0.0
A Firebase project with Firestore enabled
A Firebase service account key (JSON file)

🚀 Installation

Via npm

npm install -g firestore-advanced-mcp

Via GitHub

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

🔧 Configuration

Get your Firebase service account key :
- Go to the Firebase console
- Select your project
- Project Settings > Service Accounts
- Generate a new private key and upload the JSON file
Set the environment variable :

export SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json"

🖥️ Use

With npm global

SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json" firestore-advanced-mcp

With npx

SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json" npx firestore-advanced-mcp

From the cloned directory

SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json" node index.js

Configuration in Claude

To use this MCP server with Claude, add the following configuration to your claude_desktop_config.json file:

"firebase-mcp": {
  "command": "npx",
  "args": ["firestore-advanced-mcp"],
  "env": {
    "SERVICE_ACCOUNT_KEY_PATH": "/chemin/vers/votre/serviceAccountKey.json"
  }
}

Or for a locally installed version:

"firebase-mcp": {
  "command": "node",
  "args": ["/chemin/vers/firestore-advanced-mcp/index.js"],
  "env": {
    "SERVICE_ACCOUNT_KEY_PATH": "/chemin/vers/votre/serviceAccountKey.json"
  }
}

🛠️ Available tools

The server provides the following tools to Claude:

Basic operations

firestore_get - Retrieve a document
firestore_create - Create a new document
firestore_update - Update an existing document
firestore_delete - Delete a document
firestore_query - Run a query with filters
firestore_list_collections - List available collections

Advanced queries

firestore_collection_group_query - Collection group query
firestore_composite_query - Query with multiple filters and sorts
firestore_count_documents - Count documents without retrieving everything

Special Types and Advanced Features

firestore_special_data_types - Manage GeoPoints and References
firestore_set_ttl - Configure automatic document expiration
firestore_transaction - Execute a transaction consisting of multiple operations
firestore_batch - Execute batch operations
firestore_field_operations - Atomic operations (increment, arrayUnion, etc.)
firestore_full_text_search - Full text search in documents

📝 Examples

Retrieve a document

{
  "collection": "users",
  "id": "user123"
}

Create a document with reference to another document

{
  "collection": "orders",
  "data": {
    "product": "Laptop",
    "price": 999.99,
    "fields": [
      {
        "fieldPath": "user",
        "type": "reference",
        "value": "users/user123"
      }
    ]
  }
}

Configure TTL on a document

{
  "collection": "temporaryData",
  "id": "session123",
  "expiresIn": 86400000,
  "fieldName": "expires_at"
}

Run a query with multiple filters

{
  "collection": "products",
  "filters": [
    {
      "field": "category",
      "operator": "==",
      "value": "electronics"
    },
    {
      "field": "price",
      "operator": "<",
      "value": 1000
    }
  ],
  "orderBy": {
    "field": "price",
    "direction": "asc"
  },
  "limit": 10
}

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨🏽‍💻 Author

Diez7lm

🙏 Acknowledgments

Anthropic for Claude and the Model Context Protocol
Firebase for Firestore and Developer Tools

🦾 Contribution

Contributions are welcome! Feel free to submit a pull request or report issues via GitHub issues.

📚 Additional documentation

For more information on using Firestore with Firebase, see the official Firebase documentation .

To learn more about the Model Context Protocol (MCP) and its use with Claude, see the Anthropic documentation .

Firestore Advanced MCP

Integrations