# YNAB's MCP Server

> Connect your YNAB plan to Claude or ChatGPT with the YNAB MCP server. Learn the setup steps, what you can ask, how permissions work, troubleshooting, and FAQs.

Source: https://support.ynab.com/en_us/mcp-S1wvNaXAMe

Last updated: 2026-11-19T16:31:41.720Z

With the YNAB MCP, you can connect your YNAB plan to Claude or ChatGPT. When you connect, you'll be able to use Claude or ChatGPT to analyze your YNAB plan data, including account names, categories, payees, transactions, balances, notes, and other plan details.

#### In This Article

[What Is the YNAB MCP Server?](#what)

[What You Can Do With It](#do)

[How to Connect With Claude](#claude)

[How to Connect With ChatGPT](#chatgpt)

[Troubleshooting Your MCP Connection](#troubleshooting-connection)

[Frequently Asked Questions (FAQs)](#faq)

* * *

#### Reauthorization

At times, you may need to reauthorize your AI tool's connection to YNAB; you can find [the steps to reauthorize here](#troubleshooting-connection). 

## What Is the YNAB MCP Server?

MCP (Model Context Protocol) is the open standard AI tools use to talk to other apps. With the YNAB MCP server connected, your AI tool can pull info directly from your plan when you ask — no copying and pasting, no spreadsheets, no manual lookups.

A couple of things to know up front:

*   It uses your YNAB login. You connect through OAuth, which is a secure, industry-standard way of approving the connection.
    
*   Your data stays your data. The AI only looks at your plan when you're actively chatting with it, and only pulls what it needs to answer your question. Want to disconnect? See [how to disconnect or revoke access](#faq) below.
    
*   YNAB MCP and any AI-generated responses are for general informational and educational purposes only. They are not to be considered financial, investment, tax, credit, or legal advice.
    
*   We suggest you consult with a professional advisor to review any outputs. You are responsible for reviewing any AI output before relying on it or making changes to your YNAB plan. 
    

[Back to Top](#backtotop)

* * *

## What You Can Do With It

Once you're connected, just ask:

*   "How much do I have left in Groceries this month?"
    
*   "What's my Ready to Assign right now?"
    
*   "Show me everything I spent at Costco in the last three months."
    
*   "Did I overspend any categories last month?"
    
*   "How has my Eating Out spending trended since January?"
    
*   "What's the balance in my emergency fund?"
    
*   "List every transaction over $200 this month."
    

It's especially useful for the kinds of check-ins you'd normally open a spreadsheet for:

*   **Mid-month pulse checks** — "Am I still on track in my variable categories?"
    
*   **Reflection sessions** — "Walk me through where I spent more than I assigned this quarter."
    
*   **Expense planning** — "Based on the last six months, how much should I be assigning to Auto Maintenance?"
    
*   **Quick lookups on the go** — "What's the balance in checking?"
    

#### Under the Hood

Here's what the server can share with your AI tool when you ask:

*   **Accounts** — names and balances for every account in your plan
    
*   **Categories** — every category's assigned, activity, and available amounts, plus historical data so you can ask about previous months
    
*   **Current month** — every category's assigned, activity, and available, plus Ready to Assign
    
*   **Payees** — the payees in your plan
    
*   **Plans** — names of plans you own
    
*   **Scheduled transactions** — upcoming and recurring transactions
    
*   **Targets** — the targets you've set on your categories
    
*   **Transactions** — your transaction history, filterable by date, account, category, or payee
    

And here are some changes that you can ask your AI tool to make to your plan:

*   **Assignments** — assign money to categories or move money between them in the current month
    
*   **Categories and groups** — create categories and category groups, rename them, edit notes, and move categories between groups
    
*   **Scheduled transactions** — create or edit recurring and future-dated transactions, including scheduled transfers
    
*   **Targets** — create, edit, or remove a category’s target, or snooze it for the current month
    
*   **Transactions** — add or edit transactions, including splits across multiple categories, transfers between your accounts, and changes to memos, flags, and cleared or approved status
    

[Back to Top](#backtotop)

* * *

## How to Connect With Claude

#### Prerequisites

*   Free Claude accounts include the option to connect one custom connector. If you are already connected to a different MCP, you will need Pro, Max, Team, or Enterprise
    
*   Access to claude.ai in a web browser
    
*   Your YNAB account credentials (for the OAuth authorization step)
    
*   If you have any issues with the setup steps below, [check out Claude's setup guide for more information](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)
    

#### Setup Steps

1.  **Visit Claude in your browser.** Go to [claude.ai](https://claude.ai).
    
2.  **Open Customize.** Click the _Customize_ button in the left sidebar (briefcase icon), then click _Connectors_.
    
3.  **Add a custom connector.** Click the _➕ Add_ button and choose _Add custom connector_. Enter the following details, then click _Add_:
    
    *   Name: YNAB
        
    *   Remote MCP server URL: https://api.ynab.com/mcp
        
4.  **Start the authentication process.** Your custom connector will be created, but you need to connect it before it is active. Click the _Add_ button at the bottom of the screen without changing the Authentication and OAuth client options.
    
5.  **Authorize the connection.** Click _Connect_. Claude will redirect you to YNAB's authorization screen. Choose the plan you'd like to connect and the access level you'd like to provide. Then, click _Continue._ Review our MCP Terms, agree by clicking the checkbox, and click _Authorize_ to grant Claude access to your YNAB account. You will be sent back to Claude's settings page once complete.
    
6.  **Validate the connection.** Back in Settings > Connectors, you should see the YNAB connector with a list of Tool permissions. If it still says _Connect_, click it again to complete the connection.
    
7.  **(Optional) Adjust default permissions.** By default, Claude asks for confirmation before executing any tool. You can change this so it runs tools automatically or restrict specific operations.
    
8.  **Start chatting.** Head back to Claude's chat interface. In a new conversation, click the _+_ button in the lower left to verify YNAB is listed. You're all set.
    

#### Model Training

Claude may use your conversations, including YNAB data shared through the MCP, to train its models. You can turn this off in your provider’s settings. Here's [how to opt out of model training](#model-training).

[Back to Top](#backtotop)

* * *

## How to Connect With ChatGPT

ChatGPT only supports custom MCP connections via its web application — desktop apps are not supported. It works best in Chrome; other browsers may appear to succeed but fail silently. Only accounts on Plus or higher support the developer mode required to add a custom connector.

#### Prerequisites

*   A ChatGPT account on the Plus, Pro, Team, or Enterprise plan (not Free or Go)
    
*   Google Chrome browser
    
*   Access to chatgpt.com
    
*   Your YNAB account credentials (for the OAuth authorization step)
    
*   If you have any issues with the setup steps below, [check out ChatGPT's setup guide for more information](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt)
    

#### Setup Steps

1.  **Visit ChatGPT in Chrome.** Go to [chatgpt.com ↗️](https://chatgpt.com). Make sure you are using Google Chrome.
    
2.  **Enable developer mode.** Click your avatar in the lower-left corner, then choose "Settings". Then choose "Security and login", scroll down and toggle "Developer mode" on.
    
3.  **Create a Plugin.** From the main screen, click "Plugins" on the left sidebar then click the plus icon (+) on the top-right corner to create a new plugin. Enter the following details:
    
    *   Name: YNAB
        
    *   Remote MCP server URL: https://api.ynab.com/mcp
        
    *   Authentication: OAuth (no need to change Advanced OAuth settings) 
        
    
      
    
4.  Check the box acknowledging the risk from custom MCP apps, then click _Create_.
    
5.  **Authorize the connection.** 
    
    *   ChatGPT will redirect you to a YNAB login screen if you aren't already logged in. 
        
    *   Once logged in, you'll be redirected to YNAB's authorization screen. Choose a plan and click _Authorize_ to complete the connection. 
        
    *   You will be returned to ChatGPT's settings with a green confirmation banner.
        
6.  **Start chatting.** Head back to ChatGPT's chat interface. Click the + button in the chat, then More, and then choose YNAB. You're all set.
    

ChatGPT may use your conversations, including YNAB data shared through the MCP, to train its models. You can turn this off in your provider’s settings. Here's [how to opt out of model training](#model-training).

[Back to Top](#backtotop)

* * *

## Troubleshooting Your MCP Connection

When gaining access to newly-released MCP features, you may need to reauthorize your connection to YNAB before you can take the new features for a spin.

### How to Reauthorize with Claude

1.  Open Customize  
    
2.  Click Connectors  
    
3.  Find and click on "YNAB MCP"  
    
4.  Click "Disconnect"  
    
5.  Click "Connect"
    

### How to Reauthorize with ChatGPT

1.  Click your name on the bottom right  
    
2.  Click "Settings"  
    
3.  Click "Plugins"  
    
4.  Find "YNAB MCP" and click it.  
    
5.  Click the three dots "..." on top right.  
    
6.  Click "Reconnect"
    

### How to Switch Between Read-Only and Write Permissions

When you first authorize your connection between your AI tool and YNAB via the MCP server, you will select whether you want your AI tool to only be able to read your YNAB data (read-only permissions) or if you want your AI tool to also be able to make changes to your YNAB plan data on your behalf (read and write permissions). If at any time you want to update your permissions to switch between the two options, follow the steps below.

1.  Revoke access: In YNAB, head to Account Settings → Authorized Applications, find the AI tool you connected, and click Revoke.
    
2.  Re-establish the connection in your AI tool to go through the authorization flow and update your permissions preferences.
    

[Back to Top](#backtotop)

* * *

## Frequently Asked Questions (FAQs)

### Is my data secure?

Yes. The connection uses OAuth 2.0, so your YNAB credentials are never shared with your AI tool directly — you approve the connection through YNAB, and that's it. The AI only sees your plan data when you ask it something, and only what's relevant to your question. You can revoke access at any time from Account Settings.

### How do I opt out of model training?

Claude and ChatGPT may use your conversations, including YNAB data shared through the MCP, to train their models. You can turn this off in your provider’s settings. 

*   How to [turn off model training in Claude](https://privacy.claude.com/en/articles/12109829-how-do-i-change-my-model-improvement-privacy-settings)
    
*   How to [turn off model training in ChatGPT](https://help.openai.com/en/articles/7730893-data-controls-in-chatgpt)
    

### How do I disconnect or revoke access?

In YNAB, head to **Account Settings → Authorized Applications**, find the AI tool you connected, and click _Revoke_. Access is removed from your AI tool immediately.

### Can I use this if I share plans using YNAB Together?

If you connect your plan to the YNAB MCP, your AI tool may access any plan that you own, including plans you may have shared with other YNAB Together members that may contain data that is not your own. YNAB does not control how your AI tool uses, stores, or processes that data after it receives it. You are responsible for obtaining permission from the other members of your YNAB Together group if needed. YNAB will notify affected YNAB Together members when the connection is established.

### Does it work if I have more than one plan?

Yes, the MCP server can communicate with any plans you own.

### Can the AI tool make changes to my plan?

Yes. The MCP server has both read capabilities to look at your accounts, categories, targets, transactions, and payees as well as write capabilities to add transactions, add scheduled transactions, move money, edit categories, and update targets in your plan. You can choose whether you would like your AI tool to have read-only permissions or write permissions when you establish your connection.

### Which AI tools work with the YNAB MCP server?

Only Claude, ChatGPT, and local clients like Claude Code are supported.

### Can I use this on the free plan of my AI tool?

It depends on the tool. 

*   Free Claude accounts include the option to connect one custom connector. If you are already connected to a different MCP, you will need Pro, Max, Team, or Enterprise.
    
*   ChatGPT requires Plus, Pro, Team, or Enterprise.
    
*   For anything else, check with that tool's provider to see if custom MCP connectors are supported on your plan.
    

[Back to Top](#backtotop)

* * *

## Help Us Help You!

Our Knowledge Base team reviews article feedback responses weekly, and we actively revise these articles to make them as helpful as possible. That's where you come in! Our articles are scored based on the _Yes_ or _No_ ratings received below. We also collect freeform feedback for any _No_ ratings (so our team can focus in on what you were specifically searching for!).

**Success**: Found what you were searching for? It would be super helpful if you click _Yes_ below.

**Suggestions**: Didn't find what you're searching for and you'd like to share what terms or topics you wanted? Click _No_ below. You'll then be able to submit your feedback about this article. **Please note:** the feedback submissions are anonymous, and we’re not able to respond, so make sure to use the next option if you have a specific scenario or question you would like a response to.

**Support**: If you have a question or would like a response to your specific question, [tell the chatbot you need a human or send us an email](https://support.ynab.com/en_us/how-to-get-help-SygqcvtC5) to ensure that your message gets to our Support team!

;html.help
