Firebase

Installation path

Upload your serviceAccountKey.json as a file secret at app.augmentcode.com/app/secrets: Cosmos will show you the file path it was saved to (e.g. ~/SERVICE_ACCOUNT_KEY_PATH.json). Then choose Add Server, select Local MCP, use npx as the command with -y @gannonh/firebase-mcp as arguments, and paste that path as the value of SERVICE_ACCOUNT_KEY_PATH.

Setup steps

1. 01

   Get Firebase service account key

   Go to Firebase Console → Project Settings → Service Accounts → Generate new private key. Save the downloaded serviceAccountKey.json file: you will upload it in the next step.

2. 02

   Upload the key file to Cosmos Secrets

   Go to app.augmentcode.com/app/secrets and create a new secret. Choose the file type and upload your serviceAccountKey.json. After saving, Cosmos will display the path where the file is stored in the VM (e.g. ~/SERVICE_ACCOUNT_KEY_PATH.json). Copy that path: you'll use it as the env var value.

3. 03

   Open Add Server

   Configuration → MCP Registry → Add Server in Cosmos.

4. 04

   Pick the Local MCP tab

5. 05

   Set the command

   Command

   npx
6. 06

   Add the arguments

   Args

   -y @gannonh/firebase-mcp
7. 07

   Set environment variables

   Paste the file path shown by Cosmos Secrets as the value of SERVICE_ACCOUNT_KEY_PATH. Optionally add FIREBASE_STORAGE_BUCKET for Storage support.

   SERVICE_ACCOUNT_KEY_PATH

   SERVICE_ACCOUNT_KEY_PATH=~/YOUR_SECRET_NAME.json

   FIREBASE_STORAGE_BUCKET

   FIREBASE_STORAGE_BUCKET=your-project-id.firebasestorage.app
8. 08

   Click Add, then enable

   Toggle on Cosmos Agent or CLI. For local CLI-only use (without Cosmos cloud), set SERVICE_ACCOUNT_KEY_PATH to the absolute local path of the key file on your machine instead.

Local command

Suggested name: firebase

Requires Node.js. Firebase connects via a service account key JSON file. For Cosmos cloud sessions, upload the key as a file secret at app.augmentcode.com/app/secrets: Cosmos will show you the path it was saved to in the VM (e.g. ~/YOUR_SECRET_NAME.json). Paste that path as the SERVICE_ACCOUNT_KEY_PATH value in the MCP env config. For local CLI use only, set SERVICE_ACCOUNT_KEY_PATH to the absolute path of the key on your machine.

Authentication

Service account JSON key file. Upload it at app.augmentcode.com/app/secrets: Cosmos shows you the VM file path after upload (e.g. ~/YOUR_SECRET_NAME.json). Set SERVICE_ACCOUNT_KEY_PATH to that path in the MCP env config. For local CLI only: set SERVICE_ACCOUNT_KEY_PATH to the absolute local path of the downloaded key file.