# Mapbox CLI

This section is the command reference for the **Mapbox CLI** (`mapbox`): every command group, the commands inside it, and their flags. For an introduction to the CLI, installing it, and how it behaves, see the [Mapbox CLI guide](https://docs.mapbox.com/ja/cli/guides/).

## Shared parameters

The command groups that call a Mapbox API — Accounts, Directions, Feedback, Fonts, Geocoder, Isochrone, Map Match, Matrix, Places, Search, Sprites, Static, Styles, Tilesets, and Usage — all take:

| Parameter | Description |
| --- | --- |
| `--username`/`-u` | Fills the `{username}` path placeholder. Falls back to `MAPBOX_USERNAME`, then to the signed-in user — so you can omit it once you're signed in. |
| `--token`/`-t` | Access token. Falls back to `MAPBOX_ACCESS_TOKEN`, then stored credentials. |
| `--profile <name>` | Which stored credentials to use. |
| `--id <value>` | On a command that returns a list, print only the row with that `id` or `name`. |

Each command group's own reference page lists only what's specific to it. Alphabetically, the command groups are:

### [Accounts](https://docs.mapbox.com/ja/cli/reference/accounts/)

Access tokens and the scopes an account can grant them.

### [Agent Skills](https://docs.mapbox.com/ja/cli/reference/agent-skills/)

Installs the [Mapbox Agent Skills](https://github.com/mapbox/mapbox-agent-skills) — hand-written guidance for coding agents on building with Mapbox. A different thing from Generate Skills below.

### [Authentication](https://docs.mapbox.com/ja/cli/reference/authentication/)

Signs the CLI in to your Mapbox account and manages the token every other command uses: `login`, `logout`, `refresh`, and `whoami`.

### [Commands](https://docs.mapbox.com/ja/cli/reference/commands/)

Finds the command for a task by what it does, or lists every command with its summary. A local lookup: no request and no token.

### [Completion](https://docs.mapbox.com/ja/cli/reference/completion/)

Prints a shell completion script on stdout, for bash, zsh, fish, or PowerShell.

### [Config](https://docs.mapbox.com/ja/cli/reference/config/)

Gets or sets CLI settings that persist across shells and sessions: the update check, command history, diagnostic logs, and telemetry.

### [Directions](https://docs.mapbox.com/ja/cli/reference/directions/)

Routes between two or more waypoints, from the Directions API.

### [Doctor](https://docs.mapbox.com/ja/cli/reference/doctor/)

Shows the token, proxies, and settings the next command would use. The first thing to run when a command behaves unexpectedly.

### [Feedback](https://docs.mapbox.com/ja/cli/reference/feedback/)

Reports wrong or missing map data to Mapbox, and lists what was reported.

### [Fonts](https://docs.mapbox.com/ja/cli/reference/fonts/)

The font faces map styles render text with.

### [Generate Skills](https://docs.mapbox.com/ja/cli/reference/generate-skills/)

Writes the CLI's built-in command surface out as an [Agent Skill](https://code.claude.com/docs/en/skills), for a coding agent to read. A different thing from Agent Skills above.

### [Geocoder](https://docs.mapbox.com/ja/cli/reference/geocoder/)

Converts between place names and coordinates, forward, reverse, and in batches.

### [History](https://docs.mapbox.com/ja/cli/reference/history/)

Lists and shows recent command runs.

### [Isochrone](https://docs.mapbox.com/ja/cli/reference/isochrone/)

The areas reachable from a point within a given time or distance.

### [Map Match](https://docs.mapbox.com/ja/cli/reference/map-match/)

Snaps a GPS trace to the road network.

### [Matrix](https://docs.mapbox.com/ja/cli/reference/matrix/)

Travel times and distances between every pair of points.

### [MCP](https://docs.mapbox.com/ja/cli/reference/mcp/)

Adds the Mapbox MCP servers to a coding agent: Claude Code, Codex, Visual Studio Code, or Cursor.

### [Places](https://docs.mapbox.com/ja/cli/reference/places/)

Full detail for a place, by its Search Box result ID.

### [Report](https://docs.mapbox.com/ja/cli/reference/report/)

Sends feedback about this CLI to Mapbox.

### [Search](https://docs.mapbox.com/ja/cli/reference/search/)

Text search, reverse lookup, category search, and the category list, from the Search Box API.

### [Sprites](https://docs.mapbox.com/ja/cli/reference/sprites/)

The sprite sheet a style draws its icons from, and the individual icons in it.

### [Static](https://docs.mapbox.com/ja/cli/reference/static/)

A rendered map image or raster tile from a style.

### [Styles](https://docs.mapbox.com/ja/cli/reference/styles/)

Map styles and their drafts.

### [Tilesets](https://docs.mapbox.com/ja/cli/reference/tilesets/)

Tiles by tileset ID — raster and vector — plus Tilequery, what vector features exist at or near a given point.

### [Tilesets-cli alias](https://docs.mapbox.com/ja/cli/reference/tilesets-cli/)

Forwards everything verbatim to the separately installed [Tilesets CLI](https://github.com/mapbox/tilesets-cli) — a different program from the Tilesets commands above.

### [Uninstall](https://docs.mapbox.com/ja/cli/reference/uninstall/)

Removes the `mapbox` binary. Stored credentials and a separately installed `tilesets` binary survive.

### [Usage](https://docs.mapbox.com/ja/cli/reference/usage/)

Reports account or token usage by product, by day.

### [Workflow](https://docs.mapbox.com/ja/cli/reference/workflow/) (beta)

Installs and runs workflows: named, multi-step recipes of `mapbox` commands and scripts. Beta, so it may change or be removed in any release.

## Global options

[Global options](https://docs.mapbox.com/ja/cli/reference/global-options/) — `--output`/`-o`, `--schema`, `--yes`/`-y`, `--quiet`/`-q`, `--timeout`, `--use-login`, `--no-color`, and `--debug` — apply across every command, not only the API ones above. Every command that changes something also takes `--dry-run`, which prints the request instead of sending it.