mcp-registry/firebase-mcp

    ==================
      
       /// MCP ///
      /// FIR ///
        
    ==================
        
    [server:online]
    [protocol:ready]

firebase-mcp

by gannonh

Model Context Protocol (MCP) server that lets AI assistants directly use Firebase services (Firestore, Storage, Authentication).

184
33
Open Source

Installation

1. Prerequisites
• Node.js v18 or later
• Firebase CLI (`npm i -g firebase-tools`)
• A Firebase/Google-Cloud project with billing enabled
2. Clone & install
git clone https://github.com/gannonh/firebase-mcp.git
cd firebase-mcp
npm install
3. Configure environment values
• Copy `.env.example` (if present) to `.env` and fill in keys such as:
OPENAI_API_KEY=<your-openai-key>
MCP_ALLOWED_ORIGINS=http://localhost:3000,https://yourapp.com
• Or use Firebase runtime config:
firebase functions:config:set openai.key="<YOUR_OPENAI_KEY>" mcp.allowed_origins="http://localhost:3000"
4. Link the repo to your Firebase project
firebase login
firebase use --add # pick or create a project
5. Run locally for testing
npm run build # or ts-node for dev
firebase emulators:start --only functions
Endpoints will be available at `http://127.0.0.1:5001/<project-id>/<region>/mcp/*`.
6. Deploy to production
firebase deploy --only functions
Optional
• If the repo contains Hosting, deploy both: `firebase deploy --only hosting,functions`
• Add CI by using the supplied GitHub Action workflow ( `.github/workflows/deploy.yml` ).

Documentation

# Transform Your Firebase Development with Augment Code

The Firebase MCP server supercharges Augment Code with direct Firebase integration, turning your AI coding assistant into a full-stack development powerhouse. Instead of switching between your code editor, Firebase Console, and terminal commands, you can now manage your entire Firebase backend directly through Augment Code's chat interface.

## Seamless Firebase Integration in Your Coding Workflow

With this MCP server connected to Augment Code, you gain instant access to Firestore database operations, Firebase Storage management, and user authentication—all without leaving your development environment. Augment can now query your Firestore collections to understand your data structure, upload files to Firebase Storage, fetch user information, and even help debug database queries by running them in real-time. This means you can ask Augment to "check if user authentication is working correctly" or "upload this image to Firebase Storage and generate the download URL," and it will execute these operations directly against your Firebase project.

The real productivity boost comes from the contextual awareness this creates. When you're building a feature that involves user data, Augment can simultaneously access your Firestore users collection, examine the data structure, and generate code that perfectly matches your existing schema. Building a file upload feature? Augment can test the upload process, verify file metadata, and generate the complete implementation with actual Firebase Storage URLs. This eliminates the constant context switching between your code editor and Firebase Console, while ensuring your generated code works with your real data structure rather than generic examples.

## Real-World Development Scenarios

Picture debugging a complex user authentication flow where you need to verify user records, check Firestore permissions, and validate file uploads. With Augment Code + Firebase MCP, you can simply ask "Check if user john@example.com exists, show me their profile data, and verify they can upload files to the /user-uploads directory." Augment will execute these Firebase operations, analyze the results, and provide actionable insights or generate the necessary code fixes. Similarly, when building data-driven features, you can ask Augment to "analyze the structure of my orders collection and generate a React component that displays this data," and it will query your actual Firestore data to create perfectly tailored components.

**Quick Setup for Augment Code:**
Add this configuration to your `~/Library/Application Support/Code/User/settings.json`:

```json
{
  "mcpServers": {
    "firebase-mcp": {
      "command": "npx",
      "args": ["-y", "@gannonh/firebase-mcp"],
      "env": {
        "SERVICE_ACCOUNT_KEY_PATH": "/path/to/serviceAccountKey.json",
        "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app"
      }
    }
  }
}
```

This MCP server transforms Augment Code from a code generation tool into a comprehensive Firebase development assistant that understands your data, manages your backend, and generates production-ready code that actually works with your existing Firebase infrastructure.
License: MIT License
Updated 7/15/2025

Table of Contents