Firebase

Firebase

Server to interact with Firebase services including Firebase Authentication, Firestore, and Firebase Storage.

229
Stars
41
Forks
8
Releases

Overview

Firebase MCP enables AI assistants to work directly with Firebase services, including Firestore, Storage, and Authentication. It exposes MCP-compatible tools for common Firebase operations: Firestore (add/list/get/update/delete documents, list root collections, query across subcollections), Storage (list files, get file info, upload content, upload from URL), and Authentication (get user by identifier). The server supports both stdio and HTTP transports, allowing deployment as a standalone HTTP service with session management so multiple clients can share a single server instance. Configuration relies on a Firebase service account key and an optional storage bucket, supplied via environment variables such as SERVICE_ACCOUNT_KEY_PATH and FIREBASE_STORAGE_BUCKET. The MCP server can be run via npm, using npx or a local installation, with guidance for configuring transport and port settings (MCP_TRANSPORT, MCP_HTTP_PORT, MCP_HTTP_HOST, MCP_HTTP_PATH). It also provides developer tooling and testing guidance, including Firebase emulator usage, test commands, and an MCP Inspector for interactive debugging. Client integrations include Claude Desktop, Augment Code, VS Code, and Cursor. The project includes troubleshooting, logging, and a comprehensive API reference for all supported tools.

Details

Owner
gannonh
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Firestore Tools

Provide CRUD operations for Firestore: add, list, get, update, delete documents, list root collections, and query across subcollections.

Storage Tools

Manage Firebase Storage: list files, get file info, upload content, and upload from URL.

Authentication Tools

Access and retrieve user information via the authentication service (get user by identifier).

HTTP Transport Support

Run the MCP server as a standalone HTTP service (MCP_TRANSPORT=http) with configurable port, host, and path.

Client Integrations

Designed to work with MCP clients such as Claude Desktop, Augment Code, VS Code, and Cursor.

Environment-driven Configuration

Configure the server using environment variables (SERVICE_ACCOUNT_KEY_PATH, FIREBASE_STORAGE_BUCKET, etc.) to control credentials and storage.

Emulator-based Testing

Test against Firebase emulators for development and testing (emulators:start and related commands).

Debugging & Logging

Support debugging with file logging (DEBUG_LOG_FILE) and interactive MCP Inspector tooling.

Tags

firebasemcpfirestorestorageauthenticationhttp-transportstdio-transportemulatorsnodeclient-integration