Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
npm install
npm run build2
Register it in Claude Code
claude mcp add firebase-live -- node /path/to/index.jsReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
firebase-live's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Auto-detects Firebase project from .firebaserc
- Lists Firestore collections and subcollections
- Retrieves individual Firestore documents
- Supports complex Firestore queries with filters and limits
- Filters and retrieves Cloud Function logs with regex support
Tools 6
list_collectionsList top-level Firestore collectionslist_subcollectionsList subcollections of a documentlist_documentsList documents in a collectionget_documentGet a single document by pathquery_collectionQuery with filters, ordering, limitget_function_logsGet Cloud Function logs with grep filteringEnvironment Variables
FIREBASE_PROJECT_IDThe Firebase project ID to connect to (overrides auto-detection)Try it
→List all the top-level collections in my Firestore database.
→Get the documents from the 'users' collection.
→Fetch the last 50 error logs for the 'processPayment' cloud function from the last 2 hours.
→Query the 'orders' collection for documents where status is 'pending'.
→Show me the subcollections available under the document 'users/user123'.
Original README from NigelThorne/firebase_live_mcp_server
Firebase Live MCP Server
MCP server for querying live Firebase projects - Firestore and Cloud Function logs.
Setup
npm install
npm run build
Authentication
Uses Application Default Credentials. Run:
gcloud auth application-default login
Project Detection
The server auto-detects the Firebase project from .firebaserc in the current working directory.
Override with env var:
FIREBASE_PROJECT_ID=my-project
Usage with Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"firebase-live": {
"command": "node",
"args": ["/Users/nigelthorne/code/firebase_live_mcp_server/dist/index.js"],
"cwd": "/path/to/your/firebase/project",
"env": {
"FIREBASE_PROJECT_ID": "optional-override"
}
}
}
}
The cwd should point to a directory with .firebaserc for auto-detection.
Tools
| Tool | Description |
|---|---|
list_collections |
List top-level Firestore collections |
list_subcollections |
List subcollections of a document |
list_documents |
List documents in a collection |
get_document |
Get a single document by path |
query_collection |
Query with filters, ordering, limit |
get_function_logs |
Get Cloud Function logs with grep filtering |
get_function_logs options
pattern- Regex to filter log messagesseverity- Minimum level: DEBUG/INFO/NOTICE/WARNING/ERROR/CRITICALfunctionName- Filter by function namelimit- Max entries (default 50)hoursAgo- Fetch logs from last N hours (default 1)
Required Permissions
Your gcloud account needs:
roles/datastore.viewer- Firestore read accessroles/logging.viewer- Cloud Logging read access