# FireCMS Cloud

Wires a Firebase project into FireCMS Cloud from your agent: reads what is already in Firestore, builds collections, and manages schemas, users and project settings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1281
- Author: firecmsco
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/firecmsco/firecms/tree/HEAD/packages/mcp_server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/firecms-cloud

## What it does

The server exposes FireCMS Cloud to an AI assistant. It lists Firestore root collections, walks into subcollections, drafts a schema from sampled documents and saves it into the project. The same toolset covers collection properties, project config such as name, brand colours, default locale, text search and entity history, plus project users and their roles.

Two deployment shapes. The hosted one answers at `https://api.firecms.co/mcp` and signs clients in with OAuth in the browser, so there is nothing to install. The local one runs over stdio via `npx @firecms/mcp-server` and authenticates with your Google account, which is why it can also switch on APIs, create the Firestore database and connect a project end to end. Tokens are shared with the FireCMS CLI at `~/.firecms/tokens.json`.

Every write tool needs the `admin` role on the target project; reads are open to any authenticated member. Turn on Firebase Authentication in the Firebase console before connecting a project — it is the one prerequisite with no API behind it. Skip the access rule that `connect_project_to_firecms` installs and the CMS shows nothing but a missing-security-rules message, while the tools stay quiet: they read through the backend service account, which bypasses those rules.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.firecms.co/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.firecms.co/mcp
```

2. **Platform CLI**
```bash
claude mcp add mcp_server -- npx -y @firecms/mcp-server
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp_server --url https://api.firecms.co/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp_server -- npx -y @firecms/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp_server": {
            "url": "https://api.firecms.co/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp_server": {
            "command": "npx",
            "args": [
                "-y",
                "@firecms/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp_server": {
            "type": "http",
            "url": "https://api.firecms.co/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp_server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@firecms/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp_server https://api.firecms.co/mcp
```

2. **Platform CLI**
```bash
gemini mcp add mcp_server npx -y @firecms/mcp-server
```

## When to use it
- turn an existing Firestore dataset into ready collections
- preview a collection schema without saving anything
- grant or revoke a role for a project member
- rename a project and swap its brand colours
- enable Google Cloud APIs and create a Firestore database from the agent

## Example prompts
- List the root collections and draft schemas for the ones that are not mapped yet
- Preview the inferred schema for the `orders` collection, do not save it
- Give `ivan@example.com` the `admin` role on this project

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md