Docs

Type to search every page.

AI assistants

Connect Claude Code

Add Budget Smugglers to Claude Code with one command, then sign in through the browser or use an API token.

Claude Code connects to Budget Smugglers over HTTP. Sign in through the browser, or use an API token if you’d rather not.

Add the server#

Sign in (OAuth)

Run this in a terminal:

claude mcp add --transport http budget-smugglers https://my.budgetsmugglers.app/api/mcp

Start Claude Code and type /mcp. Pick budget-smugglers and sign in. Your browser opens Budget Smugglers. Sign in, choose whether Claude Code may make changes, and choose Allow.

You can also sign in from the terminal:

claude mcp login budget-smugglers

API token

Make a token under Settings › Connections in Budget Smugglers, with Read only or Read and change access. Then run:

claude mcp add --transport http budget-smugglers https://my.budgetsmugglers.app/api/mcp \
  --header "Authorization: Bearer bsm_..."

Replace bsm_... with your token. When you make a token, the app shows this command with the token already filled in.

Use it in every project#

By default the server is only added for the folder you’re in. Add --scope user to use it everywhere:

claude mcp add --transport http --scope user budget-smugglers https://my.budgetsmugglers.app/api/mcp

Don’t use --scope project with a token. That writes the server to .mcp.json in the project, which often ends up in git.

Check it’s working#

Ask something simple:

Which accounts do I have in Budget Smugglers?

Then try a few from Things to ask.

Sign out or remove it#

  • In Claude Code, /mcp has Clear authentication for the server. Or run claude mcp logout budget-smugglers.
  • claude mcp remove budget-smugglers removes the server.
  • To cut off access from our side, disconnect the app or revoke the token under Settings › Connections.