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

One-click path: paste that URL into Claude Connectors (or any remote MCP client). A browser window opens so you can sign in and allow access — no API key paste required.

Quickstart (OAuth — recommended)

1

Get a Budgey account

Sign up free at budgeyapp.com and set up your budget (categories + pay schedule). Your agent operates on a real budget, so this part is yours.

2

Add the remote connector

In Claude (Connectors → custom MCP), Codex, Grok, Cursor, or ChatGPT developer mode, add:

https://www.budgeyapp.com/mcp

The client discovers OAuth automatically at /.well-known/oauth-authorization-server.

3

Sign in & allow access

A browser window opens on Budgey. Sign in, then tap Allow access. Your agent receives tokens and can call budgeting tools as you.

Connect a client

Agent Plugin (one package for compatible clients)

Budgey ships an Agent Plugin — the open standard supported by Codex, ChatGPT, Cursor, GitHub Copilot, Kiro, and VS Code. It bundles the MCP server config plus a skill that teaches agents Budgey's paycheck-period model. Add the repo in your client and complete the browser sign-in:

https://github.com/erichie/budgey-agent-plugin

Claude.ai & Claude Desktop (OAuth)

Settings → Connectors → Add custom connector → paste https://www.budgeyapp.com/mcp. Complete the browser sign-in / allow window. No API key header needed for this path.

Claude Code

claude mcp add --transport http budgey https://www.budgeyapp.com/mcp
# Prefer OAuth when the client prompts; or fall back to a key:
#   --header "Authorization: Bearer budgey_sk_YOUR_KEY"

Cursor / VS Code / Windsurf

Add a remote HTTP MCP server pointing at the URL above. If your client supports OAuth for remote MCP, use that; otherwise use a key from Settings → AI agents:

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

ChatGPT / Grok / others

Add remote MCP URL https://www.budgeyapp.com/mcp and complete OAuth when prompted. Catalog listing is separate; the technical surface is ready.

Optional fallback: API key

Create a budgey_sk_… key at Settings → AI agents if your client only supports static headers:

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.

Budget & periods

getBudgetSummary, getCurrentPeriodStatus, previewNextPeriod, createNextBudgetPeriod, closePeriodAndRollover, setPaySchedule

Transactions

addTransaction, updateTransaction, searchTransactions, importTransactions, batchAddTransactions, splitTransaction, findDuplicateTransactions

Categories & allocations

getCategories, createCategory, updateBudgetPeriodCategoryTotal, rebalanceCategories, rescalePeriodAllocations

Goals & savings

getGoals, createGoal, addGoalContribution, updateGoal

Recurring (Loops)

getRecurringTransactions, addRecurringTransaction, updateRecurringTransaction

Insights & analysis

getSpendingAnalysis, getBudgetHealthInsights, getTransactionStats, getSpendingByPeriod, simulateScenario, runBudgetAudit, draftWeeklyReview

Paycheck & income

getPeriodIncome, setPeriodExpectedIncome, planPayday, confirmAutoPeriodPaycheck

Bank sync (Premium)

listBankConnections, getPlaidInbox, reviewInboxItem, bulkReviewInbox, syncBankConnections, categorizeUncategorized

Memory & context

getConnectionInfo, rememberFact, recallMemories, whatDoYouKnow

Good to know