firebase-mcp

Overview

Firebase MCP is a well-documented Model Context Protocol server that enables AI assistants to interact directly with Firebase services. It provides comprehensive tools for Firestore document operations, file management in Firebase Storage, and user authentication. The server supports both stdio and HTTP transport, allowing flexible integration with various MCP clients like Claude Desktop, VS Code, and Cursor. The implementation includes proper error handling, debugging capabilities, and detailed API reference.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• firestore_add_document

  Add a document to a collection

  Try:Add a new user document to the users collectionTry:Create a new product in the inventory collection
• firestore_list_documents

  List documents with filtering

  Try:Show all documents in the orders collectionTry:List all blog posts sorted by date
• firestore_get_document

  Get a specific document

  Try:Retrieve user profile with ID 123Try:Get product details for SKU 456
• firestore_update_document

  Update an existing document

  Try:Update user email for user ID 123Try:Modify product price for SKU 456
• firestore_delete_document

  Delete a document

  Try:Delete user profile with ID 123Try:Remove product with SKU 456
• firestore_list_collections

  List root collections

  Try:Show all collections in the databaseTry:List all available data collections
• firestore_query_collection_group

  Query across subcollections

  Try:Find all comments across all postsTry:Query all user activities
• storage_list_files

  List files in a directory

  Try:Show all files in the images folderTry:List all documents in the reports directory
• storage_get_file_info

  Get file metadata and URL

  Try:Get details for logo.pngTry:Retrieve metadata for report.pdf
• storage_upload

  Upload file from content

  Try:Upload my image to Firebase StorageTry:Add document to files collection
• storage_upload_from_url

  Upload file from URL

  Try:Download and save image from https://example.com/photo.jpgTry:Copy file from public URL to storage
• auth_get_user

  Get user by ID or email

  Try:Retrieve user with email user@example.comTry:Get details for user ID 123

Comparable tools

Installation

{
  "firebase-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "@gannonh/firebase-mcp"
    ],
    "env": {
      "SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/serviceAccountKey.json",
      "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app"
    }
  }
}

FAQ

What is the Zod validation error with firestore_list_collections?

This is a known issue where the tool may return a validation error in client logs. Despite the error message, the query works correctly and returns proper collection data. It's a log-level error that doesn't affect functionality.

How do I enable debugging for the MCP server?

Set the DEBUG_LOG_FILE environment variable to 'true' to log to the default location (~/.firebase-mcp/debug.log) or specify a custom file path. You can also view logs in real-time using 'tail -f' or by capturing stderr.

Compare firebase-mcp with