Firebase MCP

Firebase MCP server for Claude Code, Cursor, Copilot and five more AI agents. Connect Firebase to Claude, Copilot, Cursor, Codex, Gemini, Windsurf, Continue.dev and Cline. One extension, 8 agents, no config files to edit.

Install. Sign in with Google. Ask your AI agent about Firebase.

Quick Start

Install from the VS Code Marketplace or Open VSX
Authenticate: the setup wizard appears on first launch
Ask your AI agent anything about Firebase

"List the top-level Firestore collections"
"Show the 10 newest documents in orders"
"Look up the Firebase user with email ana@example.com"

Prerequisites

You need one of these (the wizard will guide you):

Method	Best For	What You Need
OAuth (recommended)	Personal Google accounts	A Google Cloud project with OAuth credentials
ADC	Developers with `gcloud` CLI	Run one terminal command
Service Account	Workspace admins and servers	A JSON key file

Go to Google Cloud Console
Create a project (or select an existing one)
Enable the Cloud Firestore API and the Identity Toolkit API under APIs & Services > Library
Create OAuth credentials:
- Go to APIs & Services > Credentials
- Click Create Credentials > OAuth client ID
- Application type: Desktop app
- Copy the Client ID and Client Secret
Configure the OAuth consent screen (if prompted) and add yourself as a test user
In the extension wizard, select "OAuth" and paste your Client ID and Secret
A browser window opens: sign in with your Google account and authorize

Option B: Application Default Credentials

gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/firebase

Option C: Service Account Key

Create a service account in Google Cloud Console and give it access to your Firebase data
Download the JSON key file
In the extension wizard, select "Service Account" and pick the file

Set firebaseMcp.projectId to your Firebase project ID, or pass project_id in a request. A service account key from Project settings > Service accounts is the simplest sign-in. The account needs the Cloud Datastore Viewer and Firebase Authentication Viewer roles.

Available Tools (8)

Tool	What It Does	Example Prompt
`firestore_list_collections`	Top-level collections or a document's subcollections	"List my Firestore collections"
`firestore_get_document`	Read one document	"Show orders/1234"
`firestore_query`	Query a collection with filters, order and limit	"The 10 newest unpaid orders"
`firestore_count`	Count documents without reading them	"How many users signed up today?"
`auth_get_user`	Look up a user by UID, email or phone	"Find the user ana@example.com"
`auth_list_users`	List Authentication users	"List the first 100 users"

Firebase Admin (`firebase_admin`)

One tool, called with an action and its params.

Action	Needs `confirm: true`
`create_document(path, data)`	No
`set_document(path, data, merge?)`	Yes
`update_document(path, data)`	No
`delete_document(path)`	Yes
`create_user(email?, password?, display_name?, phone?, email_verified?)`	No
`update_user(uid, email?, password?, display_name?, phone?, email_verified?)`	No
`disable_user(uid, disabled?)`	No
`delete_user(uid)`	Yes

set_document replaces the whole document, so it needs confirm: true unless merge is true. create_document never overwrites.

Safety

Actions that delete, remove, replace or publish need confirm: true in their params. Without it the server changes nothing and returns a warning, so your AI agent has to ask you and then call again with confirm: true.

Supported AI Agents

The extension auto-registers with every AI agent it detects:

Agent	How It Registers	Config File
VS Code Copilot	VS Code API (automatic)	--
Claude Code	`~/.claude.json`	JSON
Cursor	`~/.cursor/mcp.json`	JSON
OpenAI Codex	`~/.codex/config.toml`	TOML
Google Gemini	`~/.gemini/settings.json`	JSON
Windsurf	`~/.codeium/windsurf/mcp_config.json`	JSON
Continue.dev	`~/.continue/config.yaml`	YAML
Cline	VS Code globalStorage	JSON

You can toggle individual agents on/off in Settings > search firebaseMcp.agents.

Settings

Setting	Default	Description
`firebaseMcp.authMethod`	`"oauth"`	Auth method: oauth, adc, serviceAccount
`firebaseMcp.projectId`	`""`	Firebase project ID used when a tool call does not name one.
`firebaseMcp.agents.*`	`true`	Per-agent registration toggles
`firebaseMcp.registrationScope`	`"global"`	Global or workspace registration
`firebaseMcp.autoStart`	`true`	Auto-start server on VS Code launch
`firebaseMcp.serverLogLevel`	`"info"`	Server log verbosity

Commands

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for:

Command	What It Does
`Firebase MCP: Setup Authentication`	Run the setup wizard
`Firebase MCP: Register with AI Agents`	Re-register with all detected agents
`Firebase MCP: Show Status`	Show auth method and server state
`Firebase MCP: Restart MCP Server`	Restart the background MCP server
`Firebase MCP: Check Authentication Status`	Verify credentials are valid
`Firebase MCP: View Server Logs`	Open the output channel for debugging
`Firebase MCP: Remove from All Agents`	Clean up all agent registrations

Troubleshooting

"Firebase MCP: Setup" in the status bar

Your credentials aren't configured. Click the status bar item or run Firebase MCP: Setup Authentication.

"Permission Denied" errors

Your credentials don't have access to the requested data. Make sure the Cloud Firestore API and the Identity Toolkit API are enabled in your Google Cloud project.

Server keeps crashing

Run Firebase MCP: View Server Logs to see the error. Common causes:

Expired credentials: run the setup wizard again
Node.js not found: install Node.js 22 or newer

Uninstalling cleanly

Before uninstalling, run Firebase MCP: Remove from All Agents to clean up config files.

Privacy

This extension:

Does NOT collect telemetry or send data to third parties
Communicates only with Google APIs using your own credentials
Stores credentials in VS Code's built-in SecretStorage (encrypted, per-user)
OAuth refresh tokens never leave your machine

Links

By Renzo Johnson | Published by mercurial

Firebase MCP

Renzo

Firebase MCP

Quick Start

Prerequisites

Option A: OAuth 2.0 (Browser Login), recommended

Option B: Application Default Credentials

Option C: Service Account Key

Available Tools (8)

Firebase Admin (firebase_admin)

Safety

Supported AI Agents

Settings

Commands

Troubleshooting

"Firebase MCP: Setup" in the status bar

"Permission Denied" errors

Server keeps crashing

Uninstalling cleanly

Privacy

Links

Firebase Admin (`firebase_admin`)