YNAB MCP Server

The YNAB MCP Server acts as a bridge between a user’s personal finances and their AI assistant, making budget management as simple as having a conversation. By integrating directly with "You Need A Budget" (YNAB), this tool allows users to ask an AI about their spending habits, check account balances, or get a quick summary of their financial health. It turns a static budget into a dynamic, interactive experience where an assistant can provide instant insights into where every dollar is going. Beyond simple inquiries, this server provides a comprehensive suite of tools for deep financial interaction. It enables AI assistants to list transactions, monitor category goals, and even track upcoming scheduled bills for better forecasting. For those who want to automate their workflows, the tool supports creating and updating transactions or moving money between categories to cover overspending. It even includes specialized functions for data hygiene, such as merging messy payee names or looking up geographic locations for specific transactions, ensuring the budget remains organized and accurate. For developers and power users, the server is built on the Model Context Protocol, allowing for seamless deployment via `uvx` into environments like Claude Desktop or Goose. It offers granular control through environment variables, including a "read-only" mode for security-conscious users and a single-budget mode for streamlined focus. By exposing high-level tools like `manage-financial-overview`, the server provides LLMs with the necessary context to perform complex financial reasoning, such as identifying spending patterns or suggesting budget adjustments based on historical data. This makes it a powerful asset for building sophisticated, AI-driven personal finance workflows.

Category: CRM, ERP & E-commerce

Tags: accounting, budgeting, personal-finance, transactions, ynab

Visit YNAB MCP Server

How to install and configure YNAB MCP Server

1. Installation The YNAB MCP server can be run directly without a traditional installation step using uvx, or it can be set up locally for development. Recommended (Direct Run): bash uvx ynab-mcp-server Development/From Source: bash git clone https://github.com/Jtewen/ynab-mcp-server.git cd ynab-mcp-server uv sync uv run ynab-mcp-server ---

2. Configuration To use this server with an MCP client like Claude Desktop, you must provide your YNAB Personal Access Token.

Getting Your YNAB Token 1. Go to YNAB Developer Settings. 2. Create a new Personal Access Token. 3. Copy the token value.

Claude Desktop Configuration Add the following to your claude_desktop_config.json: - MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%/Claude/claude_desktop_config.json json { "mcpServers": { "ynab-mcp": { "command": "uvx", "args": ["ynab-mcp-server"], "env": { "YNAB_PAT": "your_token_here", "YNAB_DEFAULT_BUDGET_ID": "your_budget_id_optional", "YNAB_READ_ONLY": "false" } } } }

Environment Variables | Variable | Required | Description | | --- | --- | --- | | YNAB_PAT | Yes | Your YNAB Personal Access Token. | | YNAB_DEFAULT_BUDGET_ID | No | Enables single-budget mode (hides list-budgets). | | YNAB_READ_ONLY | No | Set to true to disable all write operations (creating/updating transactions). | ---

3. Available Tools The server provides several tools for managing and analyzing your budget: - manage-financial-overview: Get or refresh a high-level overview including account balances and goals. Recommended starting point for analysis. - list-accounts: List all accounts for a specific budget. - get-month-info: Get budget details for a specific month (age of money, total budgeted, etc.). - list-categories: List all category groups and categories with their budgeted/available amounts. - list-transactions: List and search transactions for an account or month. - list-scheduled-transactions: List upcoming recurring transactions/bills. - manage-budgeted-amount: Assign money to categories or move money between them. - bulk-manage-transactions: Create, update, or delete multiple transactions. - manage-scheduled-transaction: Create, update, or delete recurring transactions. - list-payees: List all payees in the budget. - manage-payees: Merge multiple payee names to clean up data. - lookup-entity-by-id: Resolve details for a specific account, category, or payee ID. - lookup-payee-locations: Look up geographic locations associated with a payee. - list-budgets: List all available YNAB budgets (only available if no default ID is set). ---

4. Example Prompts While specific prompts aren't listed, the server is designed for tasks such as: - "Give me an overview of my current financial status." - "How much money do I have left in my Groceries category this month?" - "Move $50 from my 'Eating Out' category to 'Savings'." - "List my upcoming bills for the next two weeks." - "Find all transactions from last month related to 'Amazon'."

What you can do with YNAB MCP Server

Use Case 1: Automated Weekly Financial Health Reports Problem: Users often find it tedious to manually dig through various budget categories and accounts to understand their overall financial health or to spot where they are overspending mid-month. Solution: This MCP allows an AI assistant to pull a high-level overview of all categories and accounts. The AI can analyze spending patterns, compare current spending against goals, and provide a proactive summary of the user's financial status. Example: A user can ask, "How is my spending looking this week?" The AI uses manage-financial-overview and list-categories to identify that the user has already spent 80% of their "Dining Out" budget only halfway through the month and suggests slowing down.

Use Case 2: Intelligent "Covering Overspending" Assistant Problem: When a user overspends in one category, they must manually look through other categories to find available funds and then perform the math and transfer within the YNAB app. Solution: By using list-categories and manage-budgeted-amount, an AI can identify categories with surplus funds and automatically move money to cover overspent categories based on the user's priorities. Example: "I went $40 over in my 'Hobbies' category. Find a category with extra money I haven't used yet this month and move $40 from there to Hobbies." The AI checks for surpluses in "Clothing" or "General Savings" and executes the move.

Use Case 3: Bill Forecasting and Cash Flow Analysis Problem: Users may have enough money "Available" in YNAB categories but might not have enough liquidity in a specific checking account to cover upcoming scheduled transactions or large bills. Solution: This MCP can access list-scheduled-transactions and list-accounts to compare upcoming outflows against current account balances, acting as an early warning system for cash flow issues. Example: "Look at my upcoming bills for the next 14 days and check my Checking account balance. Will I have any issues?" The AI identifies a scheduled $1,200 mortgage payment and warns the user that their current checking balance is only $1,000, even though the "Mortgage" category is fully funded.

Use Case 4: Transaction Cleanup and Payee Standardization Problem: Imported transactions often have messy, inconsistent payee names (e.g., "AMZN MKTP US12345" vs "Amazon.com"), which makes spending reports look cluttered and inaccurate. Solution: Using list-payees and manage-payees, an AI can identify similar-looking payees and offer to merge them into a single, clean name, or bulk-update transaction descriptions for better clarity. Example*:…

Key facts

  • Open Source
  • CRM, ERP & E-commerce, Finance, Crypto & Payments
  • accounting, budgeting, personal-finance, transactions, ynab

Part of MCP Servers

Related MCP servers

  • MCP Microsoft Office Bridge — A secure, multi-user server connecting LLMs to Microsoft 365 services.
  • MCP Mempool — Access Bitcoin network data from mempool.space's API for AI agents and applications.
  • MCP NIF.PT — Query and analyze Portuguese companies using the NIF.PT public API. Supports search by NIF, company name, and city.
  • MCP Options Order Flow Server — A high-performance MCP server for comprehensive options order flow analysis.
  • MCP Open Library — A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book and…
  • MCP Orlen Wholesale Price — Model Context Protocol Servers for Orlen Wholesale Price.
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories