---
title: "YNAB MCP Server: Community Options, Setup, and Limits | Candor"
description: "YNAB has no official MCP server. The community servers that connect YNAB to Claude or ChatGPT, who keeps each one, what it can change, and what running one takes."
url: "https://candor.money/ynab-mcp"
updated: "2026-11-19"
---

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

Updated 2026-11-19. Canonical page: https://candor.money/ynab-mcp

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.

## How it works with your agent

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. Copy one setup message into Claude, ChatGPT, Claude Code, Codex, or your agent, and approve its access.
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. 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.

- [YNAB API documentation](https://api.ynab.com/)
- [YNAB's ChatGPT app](https://support.ynab.com/en_us/ynab-and-chatgpt-H1QI25JRZe)

## 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.:

|  | A YNAB server you run | A hosted YNAB server | Candor |
| --- | --- | --- | --- |
| Examples | calebl/ynab-mcp-server, you-need-an-mcp, rgarcia/ynab-mcp-server, oliverames/ynab-mcp-server | Oliver Ames's connector and Ivan Smirnov's mcpforynab.smirnovlabs.com | Candor, the finance app your agent runs. It replaces YNAB and does not connect to it |
| How it reaches your money | A YNAB personal access token you put in its settings | You sign in to YNAB, and the service stores that sign-in | Your banks, linked read-only, or your accounts added from a YNAB export |
| What your agent can change | Transactions, assigned amounts, targets, payees, and scheduled transactions. Most have a read-only setting; rgarcia's has none | The same. Oliver Ames's asks at sign-in whether to allow changes | Goals, the budget, categories, rules, and notes in Candor. Nothing at your bank |
| Where it works | Agents on the computer running it, such as Claude Desktop, Claude Code, and Codex | Claude and ChatGPT on the web, added as a custom connector | Every agent you connect, including Claude and ChatGPT on your phone |
| What the next conversation starts from | Your YNAB budget; why you changed it stays in old chats | Your YNAB budget; why you changed it stays in old chats | Your goals, the budget with its history, and each decision with its reason |
| Cost | Your YNAB subscription, $14.99/mo or $109/yr. The servers cost nothing | Your YNAB subscription. Neither service lists a charge | 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.

- [calebl/ynab-mcp-server on GitHub](https://github.com/calebl/ynab-mcp-server)
- [chrisguidry/you-need-an-mcp on GitHub](https://github.com/chrisguidry/you-need-an-mcp)
- [oliverames/ynab-mcp-server on GitHub](https://github.com/oliverames/ynab-mcp-server)

## 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.

```text
claude mcp add ynab --scope user \
  -e YNAB_API_TOKEN=your-token-here \
  -- npx -y @oliverames/mcp-server-for-ynab@latest
```

- [Custom connectors in Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)
- [Add a custom MCP server in ChatGPT](https://developers.openai.com/api/docs/guides/custom-mcp-server)

## 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.

- [The Candor Finance MCP server](https://candor.money/mcp)

## 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.

- [Start Candor from your export](https://candor.money/try-candor-free)
- [How to cancel YNAB and export your plan](https://candor.money/how-to-cancel-ynab)

## 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.

- [YNAB alternatives compared](https://candor.money/ynab-alternative)
- [Personal finance MCP servers compared](https://candor.money/personal-finance-mcp-servers)

## 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.

- [Set up Candor in Claude](https://candor.money/connect/claude)
- [Set up Candor in ChatGPT](https://candor.money/connect/chatgpt)
- [Set up Candor in Claude Code](https://candor.money/connect/claude-code)
- [Set up Candor in Codex](https://candor.money/connect/codex)

## 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](https://api.ynab.com/), YNAB
- [YNAB API changelog and OpenAPI specification](https://api.ynab.com/papi/open_api_spec.yaml), YNAB
- [YNAB's API gets even better](https://www.ynab.com/whats-new/ynabs-api-gets-even-better), YNAB, 2026-04-29
- [YNAB's ChatGPT App](https://support.ynab.com/en_us/ynab-and-chatgpt-H1QI25JRZe), YNAB, 2026-07-02
- [Reconciling Accounts](https://support.ynab.com/en_us/reconciling-accounts-a-guide-BJFE3fHys), YNAB, 2026-11-17
- [How to Export Plan Data](https://support.ynab.com/en_us/how-to-export-plan-data-Sy_CouWA9), YNAB, 2026-08-18
- [Pricing](https://www.ynab.com/pricing), YNAB
- [YNAB MCP](https://zapier.com/mcp/ynab), Zapier
- [calebl/ynab-mcp-server](https://github.com/calebl/ynab-mcp-server), GitHub
- [chrisguidry/you-need-an-mcp](https://github.com/chrisguidry/you-need-an-mcp), GitHub
- [rgarcia/ynab-mcp-server](https://github.com/rgarcia/ynab-mcp-server), GitHub
- [oliverames/ynab-mcp-server](https://github.com/oliverames/ynab-mcp-server), GitHub
- [issmirnov/ynab-mcp-server](https://github.com/issmirnov/ynab-mcp-server), GitHub
- [Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), Anthropic
- [Claude connectors directory](https://claude.com/connectors), Anthropic
- [Add a custom MCP server](https://developers.openai.com/api/docs/guides/custom-mcp-server), OpenAI

## Keep reading

- [YNAB alternatives compared](https://candor.money/ynab-alternative)
- [Personal finance MCP servers compared](https://candor.money/personal-finance-mcp-servers)
- [YNAB review: is it worth it?](https://candor.money/ynab-review)
- [Best Claude connectors for personal finance](https://candor.money/best-claude-connectors-for-personal-finance)
- [The Candor Finance MCP server](https://candor.money/mcp)
- [Plaid MCP: your bank accounts in Claude or ChatGPT](https://candor.money/plaid-mcp)
- [What budget could I actually live with?](https://candor.money/explore/realistic-budget)
- [Can you keep my money organized for me?](https://candor.money/explore/organize)
- [What changed this week, and what's coming?](https://candor.money/explore/weekly-review)

## 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. Agents can install Candor themselves from https://candor.money/START.md.
