Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Firebase Token Toolkit

Firebase Token Toolkit is a desktop app for getting the Firebase auth tokens you need while developing and testing a backend. Pick a user, click Generate, and you have a real ID token for that user, with its claims decoded underneath and a Copy button next to it. Paste it into Postman, curl or your own tests to call any API that verifies Firebase ID tokens.

It covers five jobs, each on its own tab:

TabWhat it does
UID -> Custom TokenSigns a custom token for a user with your service-account key.
UID -> ID TokenSigns a custom token and immediately exchanges it, giving you an ID token in one click.
Custom -> ID TokenExchanges a custom token you already have for an ID token.
User Custom ClaimsReads and edits the custom claims stored on a user record.
App CheckExchanges an App Check debug token for an App Check token.

A Users panel on the left lists the project’s users and searches them by email, phone or UID, so you rarely need to look a UID up by hand. Profiles keep the settings for several Firebase projects side by side, and each profile can hold the project’s web, Android and iOS apps, including API keys that are restricted to one app.

The app is a single native binary for Linux, Windows and macOS. It talks only to Google’s endpoints, only when you click something, and never writes your private key or the tokens it mints to disk.

Where to start

  1. Install the app.
  2. Collect what you need from your Firebase project: usually just a service-account key. The app can read the project’s web, Android and iOS apps itself.
  3. Follow the Quick start to your first ID token.

Have a specific question? The FAQ answers the common ones.

Use a development project. A service-account key can sign in as any user in its project, and the app shows real tokens on screen. Read the Security page before pointing it at anything that matters.

If you find this useful, please consider starring the project on GitHub, it really helps!