Does YNAB have an official MCP server?
No. As of November 19, 2026, YNAB's API documentation lists two official integrations, its API starter kit and Zapier, and no MCP server. YNAB's official ChatGPT app surfaces YNAB articles and a debt payoff calculator, and YNAB says it cannot see your plan. Every YNAB MCP server is a community project on YNAB's API, and YNAB says it does not support community apps.
In April 2026, YNAB let outside apps create and change categories, targets, and payees, and said it had people using AI assistants in mind. We found no YNAB entry in Claude's public connector directory.
The nearest thing to an official route is Zapier. YNAB built and supports its Zapier integration, and Zapier's MCP server can hand your agent two of its actions: adding a transaction and budgeting an amount to a category.
Which YNAB MCP servers can you use?
Five open-source servers are kept up to date. All are MIT licensed, and all can change your budget. Most can be set to read only, and two also run as hosted services you sign in to with YNAB. The table names them.
Pick by where you want the server to run and how much you want your agent to change.
Examples
- A YNAB server you run
- calebl/ynab-mcp-server, you-need-an-mcp, rgarcia/ynab-mcp-server, oliverames/ynab-mcp-server
- A hosted YNAB server
- Oliver Ames's connector and Ivan Smirnov's mcpforynab.smirnovlabs.com
- Candor
- Candor, the finance app your agent runs. It replaces YNAB and does not connect to it
How it reaches your money
- A YNAB server you run
- A YNAB personal access token you put in its settings
- A hosted YNAB server
- You sign in to YNAB, and the service stores that sign-in
- Candor
- Your banks, linked read-only, or your accounts added from a YNAB export
What your agent can change
- A YNAB server you run
- Transactions, assigned amounts, targets, payees, and scheduled transactions. Most have a read-only setting; rgarcia's has none
- A hosted YNAB server
- The same. Oliver Ames's asks at sign-in whether to allow changes
- Candor
- Goals, the budget, categories, rules, and notes in Candor. Nothing at your bank
Where it works
- A YNAB server you run
- Agents on the computer running it, such as Claude Desktop, Claude Code, and Codex
- A hosted YNAB server
- Claude and ChatGPT on the web, added as a custom connector
- Candor
- Every agent you connect, including Claude and ChatGPT on your phone
What the next conversation starts from
- A YNAB server you run
- Your YNAB budget; why you changed it stays in old chats
- A hosted YNAB server
- Your YNAB budget; why you changed it stays in old chats
- Candor
- Your goals, the budget with its history, and each decision with its reason
Cost
- A YNAB server you run
- Your YNAB subscription, $14.99/mo or $109/yr. The servers cost nothing
- A hosted YNAB server
- Your YNAB subscription. Neither service lists a charge
- Candor
- Personal plan with your banks connected: $14.99/mo or $99/yr, 7-day free trial. Or try it free with your history from Monarch, YNAB, Copilot, or your bank.
Who keeps each YNAB MCP server, and what can it do?
None comes from YNAB. Caleb LeNoir's adds spending reports and can run on your own Cloudflare account, so it works from your phone. Chris Guidry's covers nearly all of YNAB. rgarcia's picks up new YNAB features on its own but can't be set to read only. Oliver Ames's reads only until you allow changes, and can undo them. Ivan Smirnov's is a hosted copy of Caleb's.
calebl/ynab-mcp-server reads your plan, accounts, and transactions, and reports spending by category or payee, cash flow, and charges that repeat. It can add, change, and delete transactions, set what a category has assigned, and move money between categories, unless you set YNAB_READ_ONLY to true. It runs on your computer, or you deploy it to your own Cloudflare account behind a sign-in so it works from your phone.
you-need-an-mcp, written in Python, also assigns money, edits categories and targets, and enters scheduled transactions early. It labels every tool as reading, adding, changing, or deleting, so your agent can ask you before a change, and YNAB_READ_ONLY leaves out every tool that changes the plan.
rgarcia/ynab-mcp-server builds its tools from YNAB's published API description each time it starts, so new YNAB features show up without an update, and it gives setup steps for Claude Code, Codex, Cursor, and the ChatGPT desktop app. It has no read-only setting.
oliverames/ynab-mcp-server offers only reading tools until you add YNAB_ALLOW_WRITES=1, and it records changes so they can be undone. issmirnov/ynab-mcp-server exists only as a hosted service: you add its address to Claude or ChatGPT, sign in with YNAB, and it stores your YNAB sign-in on Cloudflare.
How do you connect YNAB to Claude or ChatGPT?
For a server you run, create a personal access token in YNAB under Account Settings, then Developer Settings, then New Token, and add the server to Claude Desktop, Claude Code, or Codex with the token in its settings. For a hosted server, add its address as a custom connector in Claude or ChatGPT on the web and sign in to YNAB when it asks.
YNAB shows the token once, and it works until you revoke it. YNAB says to treat it with as much care as your account password and never share it.
Claude reaches a custom connector from Anthropic's cloud, so a server on your laptop works in Claude Desktop and Claude Code but cannot be added in Claude on the web or your phone. Claude's Free plan allows one custom connector. In ChatGPT on the web, open Plugins, select the plus button, and choose Add custom MCP server; your workspace's permissions decide whether you can, and ChatGPT asks before each change by default.
In Claude Code, one command adds Oliver Ames's server, which can only read until you allow changes.
claude mcp add ynab --scope user \ -e YNAB_API_TOKEN=your-token-here \ -- npx -y @oliverames/mcp-server-for-ynab@latest
What can't your agent do through a YNAB MCP server?
It cannot link a bank or repair a connection that stopped importing; YNAB's API only reports that one is broken. It cannot keep your reasons, so why you moved money or kept a charge stays in old chats. And it works inside YNAB's method, so assigning each paycheck and reconciling, which YNAB recommends at least weekly, are still yours to keep up.
YNAB also allows 200 requests an hour for each token, counted over a rolling hour. A long cleanup, such as categorizing a few months of transactions, can stop partway and pick up again later.
A server with changes turned on can delete transactions, and calebl's server warns that a deletion cannot be undone. Start with the read-only setting, and turn changes on for one job at a time.
What do you get with Candor instead of a YNAB server?
A budget your agent keeps. A YNAB server hands your agent YNAB's budget, which you still keep by hand. With Candor, your agent sets up the budget that pays for your goals from your real accounts and keeps it current. Candor calculates the figures from your records, keeps each decision with its reason, and tells your agent where you have the most to gain.
Say you want a house deposit saved by next fall. Your agent works out the monthly amount from your income and spending, then saves the goal and the budget that pays for it. When groceries start running ahead or a subscription goes up, Candor's review raises it with the records behind it, and your agent brings it to you with the figures while there's time to adjust. Next month's conversation starts from that plan, in Claude, ChatGPT, or whichever agent you open.
Candor connects to banks read-only and has no tool to move money, pay a bill, trade, or cancel a service. Your agent reads and updates your goals, budget, categories, and notes, and every read and change it makes is recorded with its reason. Candor links US banks only.
No card needed to start.
Can you bring your YNAB history to Candor?
Yes. In YNAB on the web, select your plan's name at the top of the sidebar and choose Export Plan. Give the download to your agent or upload it in Candor, and your agent adds your accounts and transactions with YNAB's categories. YNAB's plan itself, its assigned amounts and targets, does not come over. Your agent sets up a new budget from your spending with you.
Should you use a YNAB MCP server or switch to Candor?
Use a YNAB server if YNAB's method works for you and you want help with the tedious parts, such as categorizing a backlog or asking how much is left for groceries. Switch to Candor if keeping the budget is the part that keeps slipping, and you want your agent to keep it, with your goals and reasons saved between conversations.
A self-run server also suits anyone who wants their YNAB token to stay on their own machine and is happy to install and update it.
How do you set up Candor with your agent?
Create a Candor account. The Personal plan connects your US banks, cards, and brokerages, so every account and transaction comes in on its own and Candor always reviews current records. Or try it free with your history from Monarch, YNAB, Copilot, or your bank. Then paste one setup message into your agent and approve its access on Candor's page.
Claude, ChatGPT, Claude Code, Codex, Hermes, and other agents that support MCP connect to Candor's hosted server, so there is no token to create or process to keep running. Each agent's setup guide covers its own steps and how to check it worked.
How was this page checked?
YNAB facts come from YNAB's API documentation, help center, pricing page, and announcements. Each server was checked in its GitHub repository for its maintainer, license, latest activity, and tools, and the Claude and ChatGPT steps on Anthropic's and OpenAI's own pages, all on November 19, 2026. We publish Candor, so we have a stake here, and the page says when a YNAB server is the better choice.
Common questions
- Is there an official YNAB MCP server?
- No. As of November 19, 2026, YNAB's official integrations are its API starter kit and Zapier. Every YNAB MCP server is a community project, and YNAB's own ChatGPT app cannot see your plan.
- Does YNAB work with Claude?
- Through a community server. Add one to Claude Desktop or Claude Code with a YNAB personal access token, or add a hosted one as a custom connector in Claude and sign in to YNAB. YNAB has no connector of its own in Claude.
- Can a YNAB MCP server change my budget?
- Yes, unless you turn changes off. The community servers can add, edit, and delete transactions, set assigned amounts, and move money between categories. calebl's and Chris Guidry's servers have a read-only setting, and Oliver Ames's reads only until you allow changes.
- Is it safe to give a YNAB MCP server my token?
- On your own machine, the risk is the token itself: anyone who has it can read and change your budget until you revoke it in YNAB. A hosted server keeps your YNAB sign-in on someone else's servers, so check who runs it before you connect.
- Does Candor connect to YNAB?
- No. Candor links your banks itself, read-only, or your agent adds your accounts from a YNAB export. Your agent then keeps the budget in Candor instead of YNAB.
- How much does Candor cost?
- Candor's Personal plan connects your US banks, cards, and brokerages, so every account and transaction comes in on its own and Candor always reviews current records. It costs from $8.25 a month on the annual plan ($99 a year), or $14.99 month to month, and its first 7 days are free. You can also try Candor free first. Bring your history over from Monarch, YNAB, Copilot, or your bank. Download your transactions there, and your agent adds your accounts from the file.
Sources
- YNAB API documentation: tokens, rate limits, and Works with YNAB YNAB
- YNAB API changelog and OpenAPI specification YNAB
- YNAB's API gets even better YNAB, April 29, 2026
- YNAB's ChatGPT App YNAB, July 2, 2026
- Reconciling Accounts YNAB, November 17, 2026
- How to Export Plan Data YNAB, August 18, 2026
- Pricing YNAB
- YNAB MCP Zapier
- calebl/ynab-mcp-server GitHub
- chrisguidry/you-need-an-mcp GitHub
- rgarcia/ynab-mcp-server GitHub
- oliverames/ynab-mcp-server GitHub
- issmirnov/ynab-mcp-server GitHub
- Get started with custom connectors using remote MCP Anthropic
- Claude connectors directory Anthropic
- Add a custom MCP server OpenAI