Skip to main content
Bruno MCP works with Claude Code, Cursor, VS Code, Claude Desktop, Codex, and other MCP clients. Pick a path below.
Requires Node.js 20.12 or later. The server is published on npm as @usebruno/mcp. MCP clients run it with npx, so there is nothing to install up front.

Let your AI assistant set it up

Copy and send this message to your agent (Claude Code, Codex, Cursor, or any other MCP client).

Set up from your terminal

It finds the MCP clients on your machine (Claude Code, Claude Desktop, Cursor, VS Code, Codex), lets you pick some or all of them, and adds Bruno MCP to each. Existing servers are kept. A client that already has bruno is left as is. To skip the prompt (for example in a script).

Claude Code

Verify with claude mcp list, then open a new session.

Cursor

One-click install

Install in Cursor

Manual config

Add to ~/.cursor/mcp.json.
Reload Cursor, or toggle the server in Settings > MCP.

VS Code

One-click install

Install in VS Code

Manual config

Add to ~/.copilot/mcp-config.json.
Reload the window (Developer: Reload Window).

Codex

Or add to ~/.codex/config.toml.
Check it with codex mcp list, then start a new session.

Claude Desktop

Add the same bruno entry to
  • macOS ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows %APPDATA%\Claude\claude_desktop_config.json
Fully quit Claude Desktop (⌘Q on macOS) and reopen it. Collections are discovered automatically. To pin one, append "--collection", "/path/to/collection" to args (see Options).

MCP Inspector

How it finds collections

At startup the server resolves which collections to expose. The first non-empty source wins.
  1. Explicit flags. --collection / --workspace (both repeatable). A workspace expands to its member collections.
  2. CWD walk-up. Looks for bruno.json / opencollection.yml / workspace.yml walking up from the working directory the client spawned the server in.
  3. Bruno desktop preferences (on by default, use --no-auto-discovery to disable). Uses lastOpenedWorkspaces, lastOpenedCollections, and the default workspace from preferences.json.
    • macOS ~/Library/Application Support/bruno/preferences.json
    • Windows %APPDATA%/bruno/preferences.json
    • Linux ~/.config/bruno/preferences.json
You can also give the assistant any collection’s absolute path directly. It does not need to be discovered first.

Options

Options are passed as CLI flags when the client spawns the server.
npx @usebruno/mcp setup is the install command in Set up from your terminal. It takes --client <id> (claude-code, claude-desktop, cursor, vscode, codex, repeatable) and --all. Example with an explicit collection.

Next steps

  • Tools - What the assistant can read, run, and write.
  • Overview - Why Bruno MCP exists and example prompts.