Budgey
Budgey
Paycheck budgetingCompare appsPricingSign inGet started

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 Budgey 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 pay 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

  • 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 pick another one in ChatGPT plugin settings, or send 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. Core is $5/mo or $40/yr with live bank sync for 1 bank. Plus is $10/mo or $100/yr for 2 or more banks. There is no free plan. getConnectionInfo reports the caller's plan.
  • LLM crawling welcome: see /llms.txt.
  • Questions or ideas? Email support@budgeyapp.com.

Budgey

Budgeting that lets you live

By using Budgey, you agree to the terms and privacy policy. If you do not agree, please discontinue use of the app.

Product

  • Pricing
  • Who Budgey Is For
  • Compare Apps
  • Switch to Budgey
  • AI Agents & Developers

Learn

  • Blog
  • Budgeting Guides
  • Newsletter
  • Sponsor

Company

  • About Us
  • Terms and Conditions
  • Privacy Policy

Budget by paycheck

  • Paycheck budgeting app
  • How to budget by paycheck
  • What's left of your paycheck calculator
  • Three-paycheck months
  • Which bill on which paycheck
  • Paycheck budget template
  • Envelope budget app
  • Budget app for couples

Alternatives

  • Mint alternatives
  • YNAB alternatives
  • Monarch alternatives
  • EveryDollar alternatives
  • Goodbudget alternatives
  • PocketGuard alternatives
  • Budgey vs YNAB
  • All comparisons

Copyright © 2026 Budgey Platforms, LLC