firestore-mcp

A Model Context Protocol (MCP) server that provides secure, permission-controlled access to Firebase Firestore. This server allows AI assistants and other MCP clients to interact with Firestore databases through a standardized interface.

• 🔐 Granular Permissions: Control access at the collection and operation level
• 📄 Full CRUD Operations: Create, read, update, and delete documents
• 🔍 Advanced Queries: Support for filtering, ordering, and limiting results
• 📁 Subcollection Support: Work with nested collections and documents
• 🔄 Batch Operations: Execute multiple operations atomically
• 💾 Transactions: Ensure data consistency with transactional operations
• 🎯 Field Value Operations: Atomic increments, array operations, and server timestamps

• ✅ Collection-level access control
• 🛡️ Operation-specific permissions (read, write, delete, query)
• 🔒 Default deny with explicit allow rules
• 📋 Conditional permissions (coming soon)

npm install mcp-firestore
# or
yarn add mcp-firestore
# or
pnpm add mcp-firestore

git clone https://github.com/yourusername/mcp-firestore.git
cd mcp-firestore
pnpm install
pnpm build

Create a .env file with your Firestore configuration:

# Required
FIRESTORE_PROJECT_ID=your-project-id

# Optional - for authentication
GOOGLE_APPLICATION_CREDENTIALS=path/to/service-account.json

Create a permissions.json file to control access:

{
  "collections": [
    {
      "collectionId": "users",
      "operations": ["read", "write", "query"]
    },
    {
      "collectionId": "posts",
      "operations": ["read", "query"]
    }
  ],
  "defaultAllow": false
}

# With default permissions
mcp-firestore

# With cus