Firebase MCP Server

Enables create, read, update, and delete operations on Firestore documents through MCP tool bindings that map to Firebase Admin SDK methods. Implements document-level operations with support for nested collections, batch writes, and transaction-aware updates. The MCP server translates tool calls into Firebase SDK calls, handling authentication via service account credentials and managing connection pooling to the Firestore backend.

Provides user creation, deletion, password reset, and metadata management operations through MCP tool bindings to Firebase Authentication. The server uses Firebase Admin SDK's auth module to perform identity operations, supporting custom claims assignment, email verification, and user attribute updates. Tool calls are translated to Admin SDK methods with proper error handling for auth-specific exceptions like duplicate emails or invalid credentials.

Enables file operations on Google Cloud Storage buckets through MCP tools that wrap Firebase Admin SDK's storage module. Supports uploading files with custom metadata, downloading files with streaming, deleting objects, and listing bucket contents with filtering. The MCP server manages authentication via service account credentials and handles multipart uploads for large files, translating tool calls into GCS API operations with proper error handling for quota and permission issues.

Provides operations on Firebase Realtime Database through MCP tools that map to Admin SDK database methods. Supports reading data at paths, writing/updating values with optional validation rules, deleting nodes, and managing real-time listeners. The MCP server translates tool calls to RTDB API operations, handling JSON serialization, path-based access control via security rules, and connection management to the RTDB backend.

Automatically generates MCP-compliant tool schemas for all Firebase operations (Firestore CRUD, Auth, Storage, RTDB) and validates incoming tool calls against these schemas. The server implements JSON Schema validation for tool parameters, ensuring type safety and providing detailed error messages for invalid inputs. Tool schemas are exposed through the MCP protocol's tool listing endpoint, allowing clients to discover available operations and their parameter requirements.

Manages Firebase service account authentication and maintains pooled connections to Firebase services (Firestore, Auth, Storage, RTDB) through a centralized credential handler. The MCP server loads service account JSON keys, initializes Firebase Admin SDK with proper configuration, and reuses authenticated connections across multiple tool calls. This eliminates per-call authentication overhead and ensures consistent identity context for all Firebase operations.

Translates Firebase Admin SDK exceptions (auth errors, permission denied, quota exceeded, etc.) into structured error responses that are returned through MCP tool call results. The server catches Firebase-specific exceptions, extracts error codes and messages, and provides actionable error details to clients. This enables agents to handle Firebase failures gracefully and implement retry logic based on error types.

Implements the Model Context Protocol (MCP) server specification, handling tool call requests from MCP clients, routing them to appropriate Firebase operation handlers, and returning results in MCP-compliant format. The server manages the MCP transport layer (stdio, HTTP, or other transports), parses incoming tool call messages, invokes the corresponding Firebase operation, and serializes results back to the client in MCP format.