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/budgey-platforms/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

Add https://www.budgeyapp.com/mcp as a custom MCP connector and finish OAuth. After that, ChatGPT can open This paycheck from the sidebar, @mention a category, a goal, or this paycheck on desktop, and pick the active budget in plugin settings. Submit the plugin package at platform.openai.com/plugins to list it in the ChatGPT directory.

Grok and other MCP clients

Add the same remote MCP URL and complete OAuth when prompted. Leftover and afford cards return the same figures as text when the client has no iframe UI.

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