Skip to content

YNAB MCP: connect YNAB to Claude, ChatGPT, or your agent, and know what it can't do.

YNAB has no official MCP server or Claude connector. Every YNAB MCP server is a community project built on YNAB's API: you run one on your computer with a YNAB personal access token, or add a hosted one that has you sign in to YNAB. Either way, your agent gets YNAB's budget, and you still keep that budget by hand in YNAB. With Candor, your agent sets up the budget that pays for your goals from your real accounts and keeps it current, and Candor tells it where you have the most to gain.

What you ask your agent, and the page it reads in Candor

You

Where do I have the most to gain right now?

Your agent

Start with the car. Your Capital One loan's last payment is on the 30th, and putting that $190 toward your first home gets you the down payment by March 2028, six months sooner. After that, your Vanguard account is all in stock funds. Is any of it meant for the down payment?

Monday, September 213 connections, updated today

Today

Your latest review

Sep 21

This review raised 4 things

ChatGPT is looking into them.

  • The car loan ends this monthThe money it frees up has no place in the plan yet.
  • Shopping is over budgetWhen it runs over, it comes out of home savings.
  • Vanguard and the down paymentIt's all in stock funds, and nothing says whether any of it is for the down payment.
  • Spotify charged twiceTwo charges for the same plan in the same week.

1 thing Candor can’t see

ChatGPT will ask you about it.

  • When the lease ends

Next review Sep 28

Worth a look1

  • Shopping$236 of $200, with 9 days left in the month.$36 over

September so far

Budget

Spent on budget lines

$2,746.32

$223.68 under your budget’s pace · plus $64.18 not in your budget

Day 21 of 30of $4,100.00
Bills left this month
3 payments still to come

$412.48

$2,016.40 paid
Budget lines
Shopping is over.6 on track.

Coming up this week

Recurring
  • Sep25Comcast$79.99

Where you stand

Accounts

Net worth

$86,679.91

▴ 2.5% since Aug 21

Cash on hand
across 2 accounts

$12,810.40

You owe
Cards and loans

$1,480.49

Candor with sample data.

How it works with your agent

  1. 1

    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.

  2. 2

    Copy one setup message into Claude, ChatGPT, Claude Code, Codex, or your agent, and approve its access.

  3. 3

    Tell your agent what you want your money to do. It sets up goals and the budget that pays for them from your records.

  4. 4

    Your agent keeps the budget current, Candor saves each decision with its reason, and the same plan opens in every agent you use.

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.

Ways to use YNAB with an AI agent, and Candor instead, checked November 19, 2026 against YNAB's API documentation and each server's GitHub repository. Candor, the publisher, is listed last.
  • 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.

Start free

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

  1. YNAB API documentation: tokens, rate limits, and Works with YNAB YNAB
  2. YNAB API changelog and OpenAPI specification YNAB
  3. YNAB's API gets even better YNAB, April 29, 2026
  4. YNAB's ChatGPT App YNAB, July 2, 2026
  5. Reconciling Accounts YNAB, November 17, 2026
  6. How to Export Plan Data YNAB, August 18, 2026
  7. Pricing YNAB
  8. YNAB MCP Zapier
  9. calebl/ynab-mcp-server GitHub
  10. chrisguidry/you-need-an-mcp GitHub
  11. rgarcia/ynab-mcp-server GitHub
  12. oliverames/ynab-mcp-server GitHub
  13. issmirnov/ynab-mcp-server GitHub
  14. Get started with custom connectors using remote MCP Anthropic
  15. Claude connectors directory Anthropic
  16. Add a custom MCP server OpenAI

Have your agent set up your budget and keep it current.

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. You can also try Candor free first, with your history from the app or bank you use now. Either way, setup is one message to your agent.