Firebase MCP

What is Firebase MCP?

Firebase MCP enables AI assistants to work directly with Firebase services, including Firestore document operations, Storage file management with upload capabilities, and Authentication user management and verification. It works with MCP client applications such as Claude Desktop, Augment Code, VS Code, and Cursor.

How to use Firebase MCP?

Add the server configuration to your MCP client’s settings file (e.g., claude_desktop_config.json). Provide the required environment variable SERVICE_ACCOUNT_KEY_PATH pointing to your Firebase service account key JSON, and optionally set FIREBASE_STORAGE_BUCKET. The server can be run via npx (recommended) or from a local installation, and supports both stdio and HTTP transports.

Key features of Firebase MCP

• Firestore documents: add, list, get, update, delete
• Firestore collections: list root collections and query collection groups
• Storage files: list, get metadata, upload from content or URL
• Authentication: get user by ID or email
• HTTP transport with session management for multiple clients
• Optional file logging for debugging

Use cases of Firebase MCP

• Query and manage Firestore data through natural language conversation
• Upload files to Firebase Storage and retrieve download URLs
• Look up user details in Firebase Authentication
• Perform CRUD operations on documents without writing code
• Debug Firebase queries with file logging and MCP Inspector

FAQ from Firebase MCP

What prerequisites are needed to run Firebase MCP?

You need a Firebase project with a service account key (JSON), and a Node.js environment.

Does the firestore_list_collections tool have a known issue?

Yes. It may show a Zod validation error in client logs, but the query still works correctly; this is a log-level bug in the MCP SDK that does not affect functionality.

How do I fix a “Storage Bucket Not Found” error?

Verify your bucket name in the Firebase Console and set the correct value in the FIREBASE_STORAGE_BUCKET environment variable.

What should I do if I get a “composite index required” error?

Follow the URL provided in the error message to create the required composite index in the Firebase Console, then retry the query after the index is ready.

How can I enable debugging for Firebase MCP?

Set DEBUG_LOG_FILE=true in the environment to log to ~/.firebase-mcp/debug.log, or specify a custom path for file logging. You can also use the MCP Inspector for interactive debugging.