mcpField
F
firebase-local-env-setup

firebase-local-env-setup

github.com/firebaseDevelopment4915.1k installsUpdated 1d ago
Repository

About firebase-local-env-setup

This skill guides agents through the local setup required before Firebase work, including checks for Node.js, the Firebase CLI, and authentication. It also directs installation of skills and an MCP server according to the agent environment.

Key features

  1. 01Checks for Node.js version 20 or later
  2. 02Verifies Firebase CLI availability
  3. 03Guides Firebase authentication
  4. 04Selects setup instructions by agent
  5. 05Requires all checks before other tasks

Use cases

  1. 01Preparing a local Firebase development environment
  2. 02Configuring agent access to Firebase projects
  3. 03Checking Firebase tools and login status

MCP support

The skill requires installing the Firebase MCP server for the agent to manage Firebase. Setup instructions depend on the agent environment.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/firebase/agent-skills --skill firebase-local-env-setup

After installing, type/firebase-local-env-setupin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
antigravity.md
claude_code.md
cursor.md
gemini_cli.md
github_copilot.md
other_agents.md

Details

From the project README

Firebase Local Environment Setup

This skill documents the bare minimum setup required for a full Firebase experience for the agent. Before starting to use any Firebase features, you MUST verify that each of the following steps has been completed.

1. Verify Node.js

  • Action: Run node --version.

  • Handling: Ensure Node.js is installed and the version is >= 20. If Node.js is missing or < v20, install it based on the operating system:

    Recommended: Use a Node Version Manager This avoids permission issues when installing global packages.

    For macOS or Linux:

    1. Guide the user to the official nvm repository.
    2. Request the user to manually install nvm and reply when finished. Stop and wait for the user's confirmation.
    3. Make nvm available in the current terminal session by sourcing the appropriate profile: 
      # For Bash
source ~/.bash_profile
source ~/.bashrc

# For Zsh
source ~/.zprofile
source ~/.zshrc
    4. Install Node.js: 
      nvm install 24
nvm use 24

    For Windows:

    1. Guide the user to download and install nvm-windows.
    2. Request the user to manually install nvm-windows and Node.js, and reply when finished. Stop and wait for the user's confirmation.
    3. After the user confirms, verify Node.js is available: 
      node --version

    Alternative: Official Installer

    1. Guide the user to download and install the LTS version from nodejs.org.
    2. Request the user to manually install Node.js and reply when finished. Stop and wait for the user's confirmation.

2. Verify Firebase CLI

The Firebase CLI is the primary tool for interacting with Firebase services.

  • Action: Run npx -y firebase-tools@latest --version.
  • Handling: Ensure this command runs successfully and outputs a version number.

3. Verify Firebase Authentication

You must be authenticated to manage Firebase projects.

  • Action: Run npx -y firebase-tools@latest login.
  • Handling: If the environment is remote or restricted (no browser access), run npx -y firebase-tools@latest login --no-localhost instead.

4. Install Agent Skills and MCP Server

To fully manage Firebase, the agent needs specific skills and the Firebase MCP server installed. Identify the agent environment you are currently running in and follow the corresponding setup document strictly.

Read the setup document for your current agent:

CRITICAL AGENT RULE: Do NOT proceed with any other Firebase tasks until EVERY step above has been successfully verified and completed.

Comments

Markdown supported