Firebase CLI Release Notes

To use the Firebase CLI in your development environment, see Set up or update the Firebase CLI.

Version 14.15.1 - August 28, 2025

  • Fixed an issue where core MCP tools were excluded from listTools. (#9045)
  • Fixed an issue where the MCP server failed to identify active projects.
  • Added new dataconnect_compile MCP tool.

Version 14.15.0 - August 27, 2025

  • Added additional Crashlytics tools for debugging and analyzing crashes. (#9020)
  • Updated Data Connect local toolkit to 2.12, which includes the following changes:
    • Added ImpersonateQuery, ImpersonateMutation, and IntrospectGraphql APIs to the Data Connect emulator.
    • Added support for Firebase JS SDK v12.

Version 14.14.0 - August 21, 2025

  • Fixed an SQL permission bug in sql:migrate. (#9018)
  • Fixed an issue where firebase init dataconnect:sdk generated inconsistent package names. (#9021)
  • Added a configDir configuration option to specify a custom directory for .env files in Cloud Functions. (#9000)

Version 14.13.0 - August 20, 2025

  • Updated the Data Connect emulator to v2.11.2, which includes the following changes:
    • Fixed an issue causing SQL errors when combining aggregates and full-text search.
  • Fixed a bug where deploying Cloud Firestore indexes failed due to broken index comparison logic. (#8859)
  • Added prefix support for multi-instance Cloud Functions extension parameters. (#8911)
  • Made it possible to initialize a Data Connect project in non-interactive mode. (#8993)
  • Added two new MCP tools for Crashlytics: get_sample_crash_for_issue and get_issue_details. (#8995)
  • Added support to use Gemini to generate schema.gql and seed_data.gql in firebase init dataconnect. (#8988)
  • Fixed a bug where firebase deploy --only dataconnect didn't include GQL files in nested folders. (#8981)
  • Changed firebase deploy to create Cloud SQL instances asynchronously. (#9004)
  • Fixed an issue where database deploys did not read source code correctly. (#8985)

Version 14.12.1 - August 14, 2025

  • Updated runtime config deprecation warning to no longer show for v1 functions that only use default Firebase config. (#8963)
  • Fixed an issue where dataconnect:migrate would use an invalid temporary password when connecting to enterprise plus CloudSQL instances.
  • Updated Data Connect emulator to v2.11.1, which includes the following changes:
    • Added an app watch that collects embedded GQL into the connector folder.
    • Added a way to handle foreign key constraint error as FailedPrecondition.
  • Added support for creating Cloud Firestore Enterprise databases using firestore:databases:create --edition enterprise. (#8952)
  • Added support for Cloud Firestore Enterprise database indexes. (#8939)
  • Fixed an issue where the get_sdk_config improperly decoded file content for Android and iOS.
  • Added support for prompts, and added the deploy prompt.

Version 14.12.0 - August 06, 2025

  • Fixed issue where __name__ fields with non-default order were incorrectly filtered from index listings. (#8859)
  • Fixed an issue where firebase init dataconnect didn't enable the Data Connect API by default. (#8927)
  • Added firebase init aitools to help developers set up Firebase tools for AI in their projects (#8949 and #8927).
  • Updated the Data Connect local toolkit to v2.11.0, which includes the following changes (#8948):
    • Kotlin code generation with enums.
    • Deploying schemas with enums no longer report false breaking changes.
    • Support for ordering results by aggregate fields (min/max/count/sum/avg).
    • Support for built-in and user-defined enums to LLM Tools generation.

Version 14.11.1 - July 22, 2025

  • Added a deprecation warning for functions.config() to stderr on deploy and all functions:config commands. (#8808) (#8808)
  • Fixed issue where __name__ fields with DESCENDING order were incorrectly filtered from index listings, causing duplicate index issues and deployment conflicts. (#8859, #7629)
  • Add service account and service enablement to firebase init apptesting.
  • Updated the Data Connect toolkit to v2.10.1, which includes the following changes: (#8884)
    • Dart codegen: Issue where list enums weren't properly serialized and deserialized.
    • Dart codegen: Issue where if a Variable class has a field that is a custom scalar type, and that field has an enum, the enum is set to the incorrect type.
    • Swift codegen: For enum cases that are not known to the SDK in advance, Swift generates a _UNKNOWN case with a string associated value. The fix changes that case name from UNKNOWN to _UNKNOWN. If you have existing generated enums, you may need to rebuild your project.
    • Kotlin codegen: Add value property to the EnumValue base interface.
    • Dart codegen: Issue where nullable enum fields weren't setting the field itself as nullable.

Version 14.11.0 - July 16, 2025

  • Added experimental App Testing commands.
  • Fixed an issue where task queue functions couldn't decode non-ASCII characters. (#8836)
  • Fixed an issue where firestore:indexes wrongly removed the __name__ field. (#7629)
  • Updated Data Connect Emulator to version 2.10.0, which adds support for full-text search and user-defined enums, and moves SQL/CEL errors to the GraphQL debug_details field. (#8837)

Version 14.10.1 - July 09, 2025

  • Improved App Hosting compute service account flow for source deploys. (#8785)
  • Fixed an issue with ext:configure where params without default values couldn't be set. (#8810)
  • Updated the Data Connect emulator to v2.9.0, which includes the following changes:
    • Fixed an issue where indexes over 63 characters broke schema migration.
    • Added support for string_pattern filters, which filter string fields using regex or LIKE semantics.
  • Fixed an issue where the Data Connect emulator wasn't provided application default credentials. (#8819)
  • Fixed an issue where firebase-tools couldn't be used within 1st gen Cloud Functions due to trying to write to a read-only file. (#8821)

Version 14.9.0 - June 26, 2025

  • Added validation to check if project ID exists during project creation. (#5233)
  • Added generate_dataconnect_schema, dataconnect_generate_operation, and firebase_consult_assistant MCP tools.
  • Integrated firebase init dataconnect with the Gemini in Firebase API to generate Schema based on description. (#8596)
  • Added user-friendly warning for runtime errors from the Google Cloud Functions API. (#8713)
  • Updated Data Connect emulator to 2.8.0, which adds a README to generated Kotlin packages and drops support for macOS 10.15 (Catalina).

Version 14.8.0 - June 18, 2025

  • Updated the Data Connect emulator to use PGlite 0.3.x and Postgres 17, which fixes some crashes related to wire protocol inconsistencies. (#8679, #8658)
  • Removed container cleanup logic in functions:delete command. (#8771)
  • Fixed an issue where the IAM enablement for Genkit monitoring would try to change an invalid service account. (#8756)
  • Added a max instance default to function templates and comments to educate developers on cost controls. (#8772)
  • Added caching to API enablement checks to reduce burn of serviceusage.googleapis.com quota.
  • Updated the Data Connect local toolkit to v2.7.1, which includes the following changes
    • Kotlin codegen: Added a default value for the block\_ parameter to execute() so that it isn't necessary to specify empty {} for operations with optional variables and none are specified.
    • Changed Web SDK READMEs to link to other web framework READMEs for better discoverability.

Version 14.7.0 - June 11, 2025

  • Added emulator support to Cloud Storage MCP tools. (#8707)
  • Removed over-eager error catch in functions:list command.
  • Added validation during firebase init feature selection. (#5232)
  • Fixed an issue where the extensions emulator did not work with demo- projects. (#8720)
  • Fixed issue where --export-on-exit fails if the target directory does not exist. (#4688)
  • Fixed issue where the Firebase MCP server couldn't use application default credentials (ADC). (#8671)
  • Updated the Data Connect local toolkit to v2.7.0, which includes the following changes: (#8743)
    • Fixed an issue where unwanted link dependencies are added to package.json when multiple package managers are used in a web project.
    • Added linter warnings for naming convention violations & missing join table @table(key).

Version 14.6.0 - June 04, 2025

  • Fixed issue where projects:create didn't correctly parse the projectId and displayName input. (#8634)
  • Improved Get Database API call caching for Firestore function deployments. (#8681)
  • Increased timeout for linking CloudSQL instances to Data Connect.
  • Fixed issue where firebase use --add didn't correctly set the active project. (#8694)
  • Changed to correctly support '--database' flag in firestore:delete. (#6753)
  • Changed to always set up Data Connect SDK when FDC_CONNECTOR env var is set.
  • Changed firebase init to use FIREBASE_PROJECT env var as the default project ID.
  • Added emulator support to Firestore MCP tools. (#8700)
  • Increased npm timeout for web frameworks to 60 seconds. (#8702)
  • Added fallback to reading web framework dependencies version directly from node_modules package.json when the npm timeout is reached. (#8702)
  • Updated the Data Connect local toolkit to v2.6.3, which includes some cleanup and error message improvements. (#8667)

Version 14.5.1 - May 30, 2025

  • Fixed an issue where 'firestore.database' was accidentally treated as a required field. (#8678)

Version 14.5.0 - May 29, 2025

  • Improved log messages on skipped App Hosting source deploys. (#8674)
  • Fixed issue in firebase init where users were forced to specify emulator UI port. (#8626)
  • Added MCP tools for App Hosting. (#8605)
  • Fixed crash when starting the App Hosting emulator on applications with no dependencies. (#8624)
  • Fixed issue where, with webframeworks enabled, firebase init hosting re-prompts users for source. (#8587)
  • Updated typescript version in functions template to avoid build issue with @google-cloud/storage dependency. (#8194)
  • Updated the Firebase Data Connect local toolkit to v2.6.2, which includes the following changes: (#8667)
    • Improved error messages of auth.uid in CEL expressions when the caller is unauthenticated.
    • Fixed a bug where ExecuteGraphql with vector embedding in the emulator failed due to missing context.
  • Improved firebase init firestore + firebase deploy flow on a fresh new project without going to Console (#8653) (#8412)
  • Added support for Angular v20 to Firebase Hosting (#8672) (#8412)

Version 14.4.0 - May 15, 2025

  • Added firebase experimental:mcp command, which runs an MCP server for AI assistants to interact with Firebase resources.
  • Updated supported runtimes for Cloud Functions. Default python runtime is now 3.13. (#8534)
  • Fixed issue where Secret Manager API was not automatically enabled for functions using secrets. (#8528)
  • Changed Artifact Registry cleanup policy error to warn for CI/CD workloads. (##8513)
  • Enhance firebase init apphosting to support local source deploys. (#8479)
  • Fixed issue where firebase init hosting:github didn't correctly parse the repo input. (#8536)
  • Add GCP API client functions to support App Hosting deploy from source feature. (#8545)
  • Fixed an issue where Extensions, Cloud Functions, and App Hosting would run into issues on projects where the default compute service account was changed.
  • Changed firebase init template for functions to pin runtime version on init. (#8553)
  • Fixed an issue where updating a Cloud Function that retries would add incorrect fields to the updateMask. (#8560)
  • Fixed multi tenancy support for SSO users in the auth emulator. (#8544)
  • Add SDK autoinit capabilities to App Hosting emulator. (#8582)
  • Provision App Hosting compute service account during init flow. (#8580)
  • Updated the Firebase Data Connect local toolkit to v2.6.1, which includes the following changes: (#8598)
    • Fixed a bug where @transaction continued to execute after errors and produces more confusing errors.
    • Fixed a bug where rolled-back fields in @transaction returned data that had been invalidated by the rollback. They now correctly return null with a corresponding error "(rolled back)".
    • Disallow @check on side-effect fields if the mutation doesn't have @transaction.
    • Improved error messages when reading a field of null in CEL expressions.
    • Updated the underlying Go dependency version from v1.22.2 to v1.22.12.
    • Added the response binding to server values and @check(expr:) CEL expressions.

Version 14.3.0 - May 07, 2025

  • Fixed an issue where the prompt to create apphosting.emulator.yaml did not work with backends that are not at the project root. (#8412)
  • Fixed an issue where Terms of Service acceptance would be checked for non-human users.
  • Fixed an issue where Cloud Resource Manager was called without checking whether it is enabled on the user's project.
  • Updated the Data Connect local toolkit to v2.5.0, which includes the following changes: (#8514)
    • Fixed an issue where some server value expression errors incorrectly abort mutation execution.
    • Added README generation to Angular codegen, which explains how to use generated query and mutation injector functions.
  • Updated Emulator Suite UI to v1.15.0, which adds support for running on Firebase Studio.

Version 14.2.2 - April 30, 2025

  • Cleaned up prompt for setting up web frameworks during init dataconnect.
  • Fixed an issue were the Local Emulator Suite would check for auth when using demo- projects.
  • Updated the Data Connect local toolkit to v2.4.0, which adds support for add and remove list update transforms and fixes an issue where updating a column to null was ignored. (#8484)

Version 14.2.1 - April 23, 2025

  • Fixed an issue where init genkit checked the version of genkit instead of genkit-cli.
  • Updated the Data Connect local toolkit to v2.3.1, which contains the following changes: (#8455)
    • Added support for inc and dec update transforms for Date and Timestamp scalars.
    • Fixed a bug where OR and AND clauses may be evaluated in the incorrect order.
    • Fixed an issue where {includes: $var} or {includesAll: [$var]} clauses were not dropped if $var was missing.

Version 14.2.0 - April 16, 2025

  • Fixed an issue in the Extensions emulator where parameter default values would not be substituted into resource definitions.
  • Changed so that artifact registry dry run is kept off for policy changes. (#8419)
  • Added support for creation of paid Cloud SQL instances for Data Connect when the free trial has already been used.
  • Updated the Data Connect local toolkit to v2.2.0, which contains the following changes: (#8434)
    • Added support for aggregate functions on singular fields.
    • Added the ability to get an operation name without calling the ref function in the generated web SDK.
    • Properly enforced one-of validation on inc, dec, append, and prepend update transforms. Existing deployed connectors that violate this constraint will still work, but will need to be fixed to use list syntax before being re-deployed.
    • Fixed an issue so that when using mutations with no variables, correct types are passed in.

Version 14.1.0 - April 03, 2025

  • Fixed an issue where the Extensions emulator did not provide fallback values for v2 Cloud Firestore event triggers. (#8390)
  • Fixed an issue with prompt when Data Connect prompts developer for framework generation.
  • Fixed a bug where the Admin SDK fails with ENOTFOUND when automatically connecting to the Data Connect emulator when run in the Functions emulator. (#8379)
  • Updated the Data Connect local toolkit to v2.1.0 which includes the following changes: (#8400)
    • Added support for update transforms.
    • Added support for server value expressions for Int, Float, String, Date, Timestamp, and UUID data types.
    • Fixed an issue where CommonJS modules don't reference ref functions properly.

Version 14.0.1 - March 28, 2025

  • Fixed a bug where the Admin SDK would not automatically connect to the Data Connect emulator when run in the Cloud Functions emulator. (#8379)
  • Fixed Cloud Functions deployment failure when service account is null. (#8378)

Version 14.0.0 - March 27, 2025

  • Breaking change: Removed support for Node.js 18.
  • Changed the App Hosting flow for init emulators to now create apphosting.emulator.yaml with references to live secrets rather than apphosting.local.yaml with saved plaintext. (#8361)
  • Breaking change: Removed the apphosting:config:export command. (#8361)
  • Breaking change: Removed --location flag from apphosting commands. Instead, commands now prompt for primary region as needed.
  • Breaking change: Changed the deploy dataconnect command to now warn about unsafe connector changes and insecure operations.
  • Breaking change: Removed the experimental:functions:shell command. Use functions:shell instead.
  • Updated the Data Connect local toolkit to v2.0.0, which contains the following changes: (#8370)
    • Added support for aggregate functions in queries.
    • Breaking change: Added new types for Generated React SDKs.
    • Improved description of various auto-generated mutation fields.
    • Fixed an issue where pnpm users' SDKs weren't linked properly.
  • Added support for apphosting:secrets:grantAccess to now grant access to emails and grant multiple secrets at once. (#8357)
  • Added support for apphosting:secrets:set flows to help with test secrets. (#8359)
  • Updated init dataconnect templates to v1.
  • Fixed a bug where the emulator suite would set FIREBASE_DATACONNECT_EMULATOR_HOST instead of FIREBASE_DATA_CONNECT_EMULATOR_HOST.
  • Fixed a bug in Authentication emulator where accounts:lookup is case-sensitive for emails. (#8344)
  • Fixed a bug where function deploys didn't support shorthand notation or parameterized service accounts. (#8366)
  • Fixed an issue where sql:setup would incorrectly remove the cloudsqlsuperuser role from firebasesuperuser. (#8363)
  • Fixed a bug where appdistribution:testers:list would error out if there were no testers.
  • Fixed a bug where Vertex AI API would not be automatically enabled when emulating Data Connect services that use it.

Version 13.35.0 - March 20, 2025

  • Added support for generated Angular SDKs for Data Connect.
  • Added support in the App Hosting emulator for loading secret env vars. (#8305)
  • Fixed web frameworks deployments when using multiple hosting sites in firebase.json. (#8314)
  • Added a new command to set up a cleanup policy for functions artifacts. (#8268)
  • Added support for 3rd party builders for Angular. (#7557)
  • Fixed Google Cloud Functions (2nd gen) artifact cleanup by correctly encoding artifact names to match the format for Google Cloud Functions (2nd gen). (#8318)
  • Increased emulator UI body parser limit to match Cloud Storage emulator maximum. (#8329)
  • Fixed Data Connect setup issues for fresh databases due to IAM user not being created. (#8335)
  • Fixed an issue where ext:install used POSIX file separators on Windows machines. (#8326)
  • Updated the Data Connect local toolkit to v1.9.2, which adds support for generated Angular SDKs and updates Dart SDK fields to follow best practices. (#8347)
  • Fixed an issue where credentials from firebase login were not provided to the Data Connect emulator.
  • Fixed misleading comments in the connector.yaml template for firebase init dataconnect.
  • Improved Data Connect SQL permissions to better handle tables owned by IAM roles. (#8339)
  • Fixed an issue where the Data Connect emulator would crash after some SQL errors.

Version 13.34.0 - March 11, 2025

  • Fixed web frameworks deployments when using site in firebase.json. (#8295)
  • Added support for getting started with existing projects using dataconnect:sql:setup. (#8150)
  • Updated the Data Connect local toolkit to v1.8.5, which includes the following changes: (#8310)
    • Fixed the Int and Int64 scalars to correctly validate the int32 and int64 ranges, respectively.
    • Fixed the generated web SDK so that pnpm properly uses the link functionality.

Version 13.33.0 - March 06, 2025

  • Fixed issue where apps:init failed to detect the output directory when it was run in a directory where app was the only module.
  • Set LOG_EXECUTION_ID=true by default for Cloud Functions (2nd gen) to improve debugging by displaying execution IDs in logs. (#8276)
  • Fixed bug where function deployment was skipped for functions in a bad state. (#8289)
  • Updated the Data Connect local toolkit to v1.8.4, which includes the following changes: (#8290)
    • React hooks for mutations without args no longer require undefined to be passed when calling mutate.
    • Fixed import resolution when moduleResolution is set to bundler.
    • React code generation will now generate a README explaining how to use generated query and mutation hook functions.
    • Fixed an issue where React developers have to pass in an empty object even when all fields are optional.
    • Fixed an issue where FirebaseError wasn't being passed into UseMutationOptions.

Version 13.32.0 - February 27, 2025

  • Replaced VSCODE_CWD check to address issues running in VS Code environments. (#7471)
  • Added initial delay when loading Python functions. (#8239)
  • Enforced webframeworks enablement only on webframeworks sites. (#8168)
  • Fixed issue where apps:init throws an error on app creation.
  • Reenabled prompts for unused service deletion in deploy --only.
  • Updated Data Connect local toolkit to v1.8.3, which includes the following changes: (#8263)
    • Adds a _metadata.distance field to vector similarity search results
    • Fixes auth and request.auth when the request is unauthenticated
    • Fixes an issue with hanging commas in import statements in the generated Web SDK
    • Fixes an issue where the additional union type { __angular?: true } breaks type inference in the generated Web SDK

Version 13.31.2 - February 20, 2025

  • Fixed an issue where --import path was incorrectly resolved for the Data Connect emulator. (#8219)
  • Updated the Data Connect local toolkit to v1.8.2, which fixes an issue with a missing FirebaseError import. (