Skip to content
Back to search

firebase

MarketplaceWorks with Claude CodeGitHub

The Firebase Command Line Tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/firebase/firebase-tools with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/firebase/firebase-tools'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/firebase--firebase-tools/badge.svg)](/listings/firebase--firebase-tools)

HTML

<a href="/listings/firebase--firebase-tools"><img src="/api/listings/firebase--firebase-tools/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The Firebase Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Firebase project from the command line. This repository is also the home of the official Firebase MCP Server. For more information, please see the [Firebase MCP Server documentation](./src/mcp).

- Deploy code and assets to your Firebase projects - Run a local web server for your Firebase Hosting site - Interact with data in your Firebase database - Import/Export users into/from Firebase Auth

To get started with the Firebase CLI, read the full list of commands below or check out the [documentation](https://firebase.google.com/docs/cli).

Installation

Node Package

You can install the Firebase CLI using npm (the Node Package Manager). Note that you will need to install [Node.js](http://nodejs.org/) and [npm](https://npmjs.org/). Installing Node.js should install npm as well.

To download and install the Firebase CLI run the following command:

npm install -g firebase-tools

This will provide you with the globally accessible `firebase` command.

Standalone Binary

The standalone binary distribution of the Firebase CLI allows you to download a `firebase` executable without any dependencies.

To download and install the CLI run the following command:

curl -sL firebase.tools | bash

Commands

**The command `firebase --help` lists the available commands and `firebase <command> --help` shows more details for an individual command.**

If a command is project-specific, you must either be inside a project directory with an active project alias or specify the Firebase project id with the `-P <project_id>` flag.

Below is a brief list of the available commands and their function:

Configuration Commands

| Command | Description | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | **login** | Authenticate to your Firebase account. Requires access to a web browser. | | **logout** | Sign out of the Firebase CLI. | | **login:ci** | Generate an authentication token for use in non-interactive environments. | | **login:add** | Authorize the CLI for an additional account. | | **login:list** | List authorized CLI accounts. | | **login:use** | Set the default account to use for this project | | **use** | Set active Firebase project, manage project aliases. | | **open** | Quickly open a browser to relevant project resources. | | **init** | Setup a new Firebase project in the current directory. This command will create a `firebase.json` configuration file in your current directory. | | **help** | Display help information about the CLI or specific commands. |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 48 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "firebase",
  3. "owner": {
  4. "name": "Firebase",
  5. "email": "firebase-support@google.com"
  6. },
  7. "metadata": {
  8. "description": "Official Claude plugin for Firebase to help understand and manage your Firebase project, resources, and data",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "firebase",
  14. "description": "Claude plugin for Firebase that installs the Firebase MCP server and helps to manage Firebase projects, add backend services, add AI features, deploy & host apps, and more",
  15. "version": "1.0.0",
  16. "author": {
  17. "name": "Firebase",
  18. "url": "https://firebase.google.com/"
  19. },
  20. "homepage": "https://github.com/firebase/firebase-tools",
  21. "repository": "https://github.com/firebase/firebase-tools.git",
  22. "license": "MIT",
  23. "keywords": [
  24. "firebase",
  25. "mcp",
  26. "cloud",
  27. "firestore",
  28. "database",
  29. "hosting",
  30. "functions",
  31. "cli"
  32. ],
  33. "category": "development",
  34. "tags": ["firebase", "backend", "database", "cloud-services"],
  35. "mcpServers": {
  36. "firebase": {
  37. "description": "Firebase MCP server for understanding and managing your Firebase project, resources, and data",
  38. "command": "npx",
  39. "args": ["-y", "firebase-tools", "mcp", "--dir", "."],
  40. "env": {
  41. "IS_FIREBASE_MCP": "true"
  42. }
  43. }
  44. },
  45. "source": "./"
  46. }
  47. ]
  48. }
README.md · README · 307 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Firebase CLI and MCP Server [![Actions Status][gh-actions-badge]][gh-actions] [![Node Version][node-badge]][npm] [![NPM version][npm-badge]][npm] [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=firebase&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImZpcmViYXNlLXRvb2xzIiwibWNwIiwiLS1kaXIiLCIuIl19)
  2. The Firebase Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Firebase project from the command line. This repository is also the home of the official Firebase MCP Server. For more information, please see the [Firebase MCP Server documentation](./src/mcp).
  3. - Deploy code and assets to your Firebase projects
  4. - Run a local web server for your Firebase Hosting site
  5. - Interact with data in your Firebase database
  6. - Import/Export users into/from Firebase Auth
  7. To get started with the Firebase CLI, read the full list of commands below or check out the [documentation](https://firebase.google.com/docs/cli).
  8. > [!TIP]
  9. > Using an AI assistant? Install [Firebase agent skills](https://github.com/firebase/agent-skills) to give it Firebase-specific knowledge, best practices, and workflows, including how to use the Firebase CLI and MCP server effectively:
  10. >
  11. > ```bash
  12. > npx skills add firebase/agent-skills
  13. > ```
  14. >
  15. > See the [Firebase agent skills documentation](https://firebase.google.com/docs/ai-assistance/agent-skills) for more information.
  16. ## Installation
  17. ### Node Package
  18. You can install the Firebase CLI using npm (the Node Package Manager). Note that you will need to install
  19. [Node.js](http://nodejs.org/) and [npm](https://npmjs.org/). Installing Node.js should install npm as well.
  20. To download and install the Firebase CLI run the following command:
  21. ```bash
  22. npm install -g firebase-tools
  23. ```
  24. This will provide you with the globally accessible `firebase` command.
  25. ### Standalone Binary
  26. The standalone binary distribution of the Firebase CLI allows you to download a `firebase` executable
  27. without any dependencies.
  28. To download and install the CLI run the following command:
  29. ```bash
  30. curl -sL firebase.tools | bash
  31. ```
  32. ## Commands
  33. **The command `firebase --help` lists the available commands and `firebase <command> --help` shows more details for an individual command.**
  34. If a command is project-specific, you must either be inside a project directory with an
  35. active project alias or specify the Firebase project id with the `-P <project_id>` flag.
  36. Below is a brief list of the available commands and their function:
  37. ### Configuration Commands
  38. | Command | Description |
  39. | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
  40. | **login** | Authenticate to your Firebase account. Requires access to a web browser. |
  41. | **logout** | Sign out of the Firebase CLI. |
  42. | **login:ci** | Generate an authentication token for use in non-interactive environments. |
  43. | **login:add** | Authorize the CLI for an additional account. |
  44. | **login:list** | List authorized CLI accounts. |
  45. | **login:use** | Set the default account to use for this project |
  46. | **use** | Set active Firebase project, manage project aliases. |
  47. | **open** | Quickly open a browser to relevant project resources. |
  48. | **init** | Setup a new Firebase project in the current directory. This command will create a `firebase.json` configuration file in your current directory. |
  49. | **help** | Display help information about the CLI or specific commands. |
  50. Append `--no-localhost` to login (i.e., `firebase login --no-localhost`) to copy and paste code instead of starting a local server for authentication. A use case might be if you SSH into an instance somewhere and you need to authenticate to Firebase on that machine.
  51. ### Project Management Commands
  52. | Command | Description |
  53. | ------------------------ | ---------------------------------------------------------- |
  54. | **apps:create** | Create a new Firebase app in a project. |
  55. | **apps:list** | List the registered apps of a Firebase project. |
  56. | **apps:sdkconfig** | Print the configuration of a Firebase app. |
  57. | **projects:addfirebase** | Add Firebase resources to a Google Cloud Platform project. |
  58. | **projects:create** | Create a new Firebase project. |
  59. | **projects:list** | Print a list of all of your Firebase projects. |
  60. ### Deployment and Local Emulation
  61. These commands let you deploy and interact with your Firebase services.
  62. | Command | Description |
  63. | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
  64. | **emulators:exec** | Start the local Firebase emulators, run a test script, then shut down the emulators. |
  65. | **emulators:start** | Start the local Firebase emulators. |
  66. | **deploy** | Deploys your Firebase project. Relies on `firebase.json` configuration and your local project folder. |
  67. | **serve** | Start a local server with your Firebase Hosting configuration and HTTPS-triggered Cloud Functions. Relies on `firebase.json`. |
  68. | **setup:emulators:database** | Downloads the database emulator. |
  69. | **setup:emulators:firestore** | Downloads the firestore emulator. |
  70. ### App Distribution Commands
  71. | Command | Description |
  72. | ------------------------------------ | ---------------------------------------------------------------------------------------- |
  73. | **appdistribution:distribute** | Upload a release binary and optionally distribute it to testers and run automated tests. |
  74. | **appdistribution:testers:list** | List testers in project. |
  75. | **appdistribution:testers:add** | Add testers to project (and group, if specified via flag). |
  76. | **appdistribution:testers:remove** | Remove testers from a project (or group, if specified via flag). |
  77. | **appdistribution:groups:list** | List groups (of testers). |
  78. | **appdistribution:groups:create** | Create a group (of testers). |
  79. | **appdistribution:groups:delete** | Delete a group (of testers). |
  80. | **appdistribution:testcases:export** | Export test cases as a YAML file. |
  81. | **appdistribution:testcases:import** | Import test cases from YAML file. |
  82. ### Auth Commands
  83. | Command | Description |
  84. | --------------- | ------------------------------------------------------ |
  85. | **auth:import** | Batch importing accounts into Firebase from data file. |
  86. | **auth:export** | Batch exporting accounts from Firebase into data file. |
  87. Detailed doc is [here](https://firebase.google.com/docs/cli/auth).
  88. ### Realtime Database Commands
  89. | Command | Description |
  90. | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
  91. | **database:get** | Fetch data from the current project's database and display it as JSON. Supports querying on indexed data. |
  92. | **database:set** | Replace all data at a specified location in the current project's database. Takes input from file, STDIN, or command-line argument. |
  93. | **database:push** | Push new data to a list at a specified location in the current project's database. Takes input from file, STDIN, or command-line argument. |
  94. | **database:remove** | Delete all data at a specified location in the current project's database. |
  95. | **database:update** | Perform a partial update at a specified location in the current project's database. Takes input from file, STDIN, or command-line argument. |
  96. | **database:profile** | Profile database usage and generate a report. |
  97. | **database:instances:create** | Create a realtime database instance. |
  98. | **database:instances:list** | List realtime database instances. |
  99. | **database:settings:get** | Read the realtime database setting at path |
  100. | **database:settings:set** | Set the realtime database setting at path. |
  101. ### Extensions Commands
  102. | Command | Description |
  103. | ------------------- | ------------------------------------------------------------------------------------------- |
  104. | **ext** | Display information on how to use ext commands and extensions installed to your project. |
  105. | **ext:configure** | Configure an existing extension instance. |
  106. | **ext:info** | Display information about an extension by name (extensionName@x.y.z for a specific version) |
  107. | **ext:install** | Install an extension. |
  108. | **ext:sdk:install** | Install and SDK for an extension so you can define the extension in a functions codebase. |
  109. | **ext:list** | List all the extensions that are installed in your Firebase project. |
  110. | **ext:uninstall** | Uninstall an extension that is installed in your Firebase project by Instance ID. |
  111. | **ext:update** | Update an existing extension instance to the latest version. |
  112. ### Cloud Firestore Commands
  113. | Command | Description |
  114. | --------------------- | ------------------------------------------------------------------------------------------------------------------- |
  115. | **firestore:delete** | Delete documents or collections from the current project's database. Supports recursive deletion of subcollections. |
  116. | **firestore:indexes** | List all deployed indexes from the current project. |
  117. ### Cloud Functions Commands
  118. | Command | Description |
  119. | ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
  120. | **functions:log** | Read logs from deployed Cloud Functions. |
  121. | **functions:list** | List all deployed functions in your Firebase project. |
  122. | **functions:config:set** | Store runtime configuration values for the current project's Cloud Functions. |
  123. | **functions:config:get** | Retrieve existing configuration values for the current project's Cloud Functions. |
  124. | **functions:config:unset** | Remove values from the current project's runtime configuration. |
  125. | **functions:config:clone** | Copy runtime configuration from one project environment to another. |
  126. | **functions:secrets:set** | Create or update a secret for use in Cloud Functions for Firebase. |
  127. | **functions:secrets:get** | Get metadata for secret and its versions. |
  128. | **functions:secrets:access** | Access secret value given secret and its version. Defaults to accessing the latest version. |
  129. | **functions:secrets:prune** | Destroys unused secrets. |
  130. | **functions:secrets:destroy** | Destroy a secret. Defaults to destroying the latest version. |
  131. | **functions:delete** | Delete one or more Cloud Functions by name or group name. |
  132. | **functions:shell** | Locally emulate functions and start Node.js shell where these local functions can be invoked with test data. |
  133. ### Hosting Commands
  134. | Command | Description |
  135. | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  136. | **hosting:disable** | Stop serving Firebase Hosting traffic for the active project. A "Site Not Found" message will be displayed at your project's Hosting URL after running this command. |
  137. ### Remote Config Commands
  138. | Command | Description |
  139. | ----------------------------------- | ---------------------------------------------------------------------------------------------------------- |
  140. | **remoteconfig:get** | Get a Firebase project's Remote Config template. |
  141. | **remoteconfig:versions:list** | Get a list of the most recent Firebase Remote Config template versions that have been published. |
  142. | **remoteconfig:rollback** | Roll back a project's published Remote Config template to the version provided by `--version_number` flag. |
  143. | **remoteconfig:experiments:get** | Get a Remote Config experiment. |
  144. | **remoteconfig:experiments:list** | Get a list of Remote Config experiments |
  145. | **remoteconfig:experiments:delete** | Delete a Remote Config experiment. |
  146. | **remoteconfig:rollouts:get** | Get a Remote Config rollout. |
  147. | **remoteconfig:rollouts:list** | Get a list of Remote Config rollouts. |
  148. | **remoteconfig:rollouts:delete** | Delete a Remote Config rollout. |
  149. Use `firebase:deploy --only remoteconfig` to update and publish a project's Firebase Remote Config template.
  150. ## Authentication
  151. ### General
  152. The Firebase CLI can use one of four authentication methods listed in descending priority:
  153. - **User Token** - **DEPRECATED: this authentication method will be removed in a future major version of `firebase-tools`; use a service account to authenticate instead** - provide an explicit long-lived Firebase user token generated from `firebase login:ci`. Note that these tokens are extremely sensitive long-lived credentials and are not the right option for most cases. Consider using service account authorization instead. The token can be set in one of two ways:
  154. - Set the `--token` flag on any command, for example `firebase --token="<token>" projects:list`.
  155. - Set the `FIREBASE_TOKEN` environment variable.
  156. - **Local Login** - run `firebase login` to log in to the CLI directly as yourself. The CLI will cache an authorized user credential on your machine.
  157. - **Service Account** - set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to point to the path of a JSON service account key file. For more details, see Google Cloud's [Getting started with authentication](https://cloud.google.com/docs/authentication/getting-started) guide.
  158. - **Application Default Credentials** - if you use the `gcloud` CLI and log in with `gcloud auth application-default login`, the Firebase CLI will use them if none of the above credentials are present.
  159. ### Multiple Accounts
  160. By default `firebase login` sets a single global account for use on all projects.
  161. If you have multiple Google accounts which you use for Firebase projects you can
  162. authorize multiple accounts and use them on a per-project or per-command basis.
  163. To authorize an additonal account for use with the CLI, run `firebase login:add`.
  164. You can view the list of authorized accounts with `firebase login:list`.
  165. To set the default account for a specific Firebase project directory, run
  166. `firebase login:use` from within the directory and select the desired account.
  167. To check the default account for a directory, run `firebase login:list` and the
  168. default account for the current context will be listed first.
  169. To set the account for a specific command invocation, use the `--account` flag
  170. with any command. For example `firebase --account=user@domain.com deploy`. The
  171. specified account must have already been added to the Firebase CLI using
  172. `firebase login:add`.
  173. ### Cloud Functions Emulator
  174. The Cloud Functions emulator is exposed through commands like `emulators:start`,
  175. `serve` and `functions:shell`. Emulated Cloud Functions run as independent `node` processes
  176. on your development machine which means they have their own credential discovery mechanism.
  177. By default these `node` processes are not able to discover credentials from `firebase login`.
  178. In order to provide a better development experience, when you are logged in to the CLI
  179. through `firebase login` we take the user credentials and construct a temporary credential
  180. that we pass into the emulator through `GOOGLE_APPLICATION_CREDENTIALS`. We **only** do this
  181. if you have not already set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable
  182. yourself.
  183. ## Using behind a proxy
  184. The CLI supports HTTP(S) proxies via environment variables. To use a proxy, set the `HTTPS_PROXY`
  185. or `HTTP_PROXY` value in your environment to the URL of your proxy (e.g.
  186. `HTTP_PROXY=http://127.0.0.1:12345`).
  187. ## Using with CI Systems
  188. The Firebase CLI requires a browser to complete authentication, but is fully
  189. compatible with CI and other headless environments.
  190. Complete the following steps to run Firebase commands in a CI environment. Find detailed instructions for each step in Google Cloud's [Getting started with authentication](https://cloud.google.com/docs/authentication/getting-started) guide.
  191. 1. Create a service account and grant it the appropriate level of access to your project.
  192. 1. Create a service account key (JSON file) for that service account.
  193. 1. Store the key file in a secure, accessible way in your CI system.
  194. 1. Set `GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json` in your CI system when running Firebase commands.
  195. To disable access for the service account, [find the service account](https://console.cloud.google.com/projectselector/iam-admin/serviceaccounts) for your project in the Google Cloud Console, and then either remove the key, or disable or delete the service account.
  196. ## Using as a Module
  197. The Firebase CLI can also be used programmatically as a standard Node module.
  198. Each command is exposed as a function that takes positional arguments followed
  199. by an options object and returns a Promise.
  200. So if we run this command at our command line:
  201. ```bash
  202. $ firebase --project="foo" apps:list ANDROID
  203. ```
  204. That translates to the following in Node:
  205. ```js
  206. const client = require("firebase-tools");
  207. client.apps
  208. .list("ANDROID", { project: "foo" })
  209. .then((data) => {
  210. // ...
  211. })
  212. .catch((err) => {
  213. // ...
  214. });
  215. ```
  216. The options object must be the very last argument and any unspecified
  217. positional argument will get the default value of `""`. The following
  218. two invocations are equivalent:
  219. ```js
  220. const client = require("firebase-tools");
  221. // #1 - No arguments or options, defaults will be inferred
  222. client.apps.list();
  223. // #2 - Explicitly provide "" for all arguments and {} for options
  224. client.apps.list("", {});
  225. ```
  226. Note: when used in a limited environment like Cloud Functions, not all `firebase-tools` commands will work programatically
  227. because they require access to a local filesystem.
  228. [gh-actions]: https://github.com/firebase/firebase-tools/actions
  229. [npm]: https://www.npmjs.com/package/firebase-tools
  230. [gh-actions-badge]: https://github.com/firebase/firebase-tools/workflows/CI%20Tests/badge.svg
  231. [node-badge]: https://img.shields.io/node/v/firebase-tools.svg
  232. [npm-badge]: https://img.shields.io/npm/v/firebase-tools.svg

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.