Subchapter 5.15

Cursor

references/setup/cursor.mdMarkdown3 KBView on GitHub

Cursor Setup

To get the most out of Firebase in Cursor, follow these steps to install the agent skills and the MCP server.

Cursor · Firebase Basics · firebase/agent-skills · Skills Docs

Check Local skills: Run npx skills list --agent cursor. If the output includes firebase-basics, the skills are already installed locally.
Check Global skills: If not found locally, check the global installation by running:
```
npx skills list --global --agent cursor
```
If the output includes firebase-basics, the skills are already installed globally.
Install Skills: If both checks fail, run the following command to install the Firebase agent skills:
```
npx skills add firebase/agent-skills --agent cursor --skill "*"
```
Note: Omit --yes and --global to choose the installation location manually. If prompted interactively in the terminal, ensure you send the appropriate user choices via standard input to complete the installation.
Verify Installation: Re-run the checks in steps 1 or 2 to confirm that firebase-basics is now available.

Locate mcp.json: Find the configuration file for your operating system:
- Global: ~/.cursor/mcp.json
- Project: .cursor/mcp.json
Note: If the directory or mcp.json file does not exist, create them and initialize the file with { "mcpServers": {} } before proceeding.
Check Existing Configuration: Open mcp.json and check the mcpServers section for a firebase entry.
- It is already configured if the command is "firebase" OR if the command is "npx" with "firebase-tools" and "mcp" in the args.
- Important: If a valid firebase entry is found, the MCP server is already configured. Skip step 3 and proceed directly to step 4.
Example valid configurations:
```
"firebase": {
  "command": "npx",
  "args": ["-y", "firebase-tools@latest", "mcp"]
}
```
OR
```
"firebase": {
  "command": "firebase",
  "args": ["mcp"]
}
```
Add or Update Configuration: If the firebase block is missing or incorrect, add it to the mcpServers object:
```
"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest",
    "mcp"
  ]
}
```
CRITICAL: Merge this configuration into the existing mcp.json file. You MUST preserve any other existing servers inside the mcpServers object.
Verify Configuration: Save the file and confirm the firebase block is present and properly formatted JSON.