For AI agents & developers

Let your AI agent run your budget

Budgey speaks the Model Context Protocol. Connect Claude, Cursor, ChatGPT, or any MCP client and your agent gets the same 70+ tools our in-app assistant BaoBot uses — add transactions, plan paydays, audit spending, move money between categories, and more.

https://www.budgeyapp.com/mcp

Quickstart

Connect a client

Claude Code

claude mcp add --transport http budgey https://www.budgeyapp.com/mcp \
  --header "Authorization: Bearer budgey_sk_YOUR_KEY"

Claude.ai & Claude Desktop

Settings → Connectors → Add custom connector. Use the URL above; when asked for authentication, choose a bearer token / custom header and paste your key.

Cursor / VS Code / Windsurf

Add to your client's MCP config (e.g. .cursor/mcp.json):

{
  "mcpServers": {
    "budgey": {
      "type": "http",
      "url": "https://www.budgeyapp.com/mcp",
      "headers": { "Authorization": "Bearer budgey_sk_YOUR_KEY" }
    }
  }
}

ChatGPT

Settings → Connectors → Advanced → Developer mode, then add the MCP server URL with your key as a bearer token.

Anything else (raw HTTP)

curl -X POST https://www.budgeyapp.com/mcp \
  -H "Authorization: Bearer budgey_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

What your agent can do

Budgey is paycheck-based: money is planned per budget period (pay cycle), not per calendar month. Agents should call getConnectionInfo first to see the active budget and period.

Good to know

• A key grants full access to the account's budgets — the same powers as the signed-in user. Revoke keys anytime from Settings → AI agents.
• Tools act on your default budget's current period. Accounts with multiple budgets can target another one by sending an X-Budgey-Budget-Id header.
• The server is stateless Streamable HTTP — no session setup required, works from serverless and CLI clients alike.
• Agents bring their own LLM, so tool calls are not metered — but the app's free-plan limits apply as usual (transactions per month, categories, budget periods, one budget). getConnectionInfo reports the caller's plan and limits; Budgey Unlimited removes them.
• LLM crawling welcome: see /llms.txt.
• Questions or ideas? Email support@budgeyapp.com.