Firebase Live 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 messages
• severity - Minimum level: DEBUG/INFO/NOTICE/WARNING/ERROR/CRITICAL
• functionName - Filter by function name
• limit - Max entries (default 50)
• hoursAgo - Fetch logs from last N hours (default 1)

Required Permissions

Your gcloud account needs:

• roles/datastore.viewer - Firestore read access
• roles/logging.viewer - Cloud Logging read access