ynab-mcp MCP Server

A Model Context Protocol (MCP) server for seamless integration with You Need A Budget (YNAB). This server enables AI assistants to interact with your YNAB budgets, providing powerful automation and…

Local serverstdio

What is the ynab-mcp Server?

ynab-mcp is an MCP project maintained in the jtewen/ynab-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for seamless integration with You Need A Budget (YNAB). This server enables AI assistants to interact with your YNAB…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is ynab-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares YNAB_PAT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
manage-financial-overview	Get, update, or refresh a high-level financial overview. This is the best starting point for any analysis, providing account balances, goals, and important…
list-accounts	List all accounts for a given budget. Useful for getting account IDs for other tools.
get-month-info	Get detailed budget information for a single month, including age of money and total amounts budgeted, spent, and available. Call this to check the monthly…
list-categories	List all categories, groups, and their budgeting details. Call this before managing budgeted amounts to see what's available and what's already been allocated.
list-transactions	List transactions for a specific account or an entire month. Use this to investigate spending patterns identified in the financial overview.
list-scheduled-transactions	List all upcoming scheduled transactions. Useful for forecasting upcoming bills.
manage-budgeted-amount	Assign a budgeted amount to a category or move money between categories. This is the primary tool for allocating funds. (Write operations disabled in read-only
bulk-manage-transactions	Create, update, or delete multiple transactions at once. More efficient than making single changes. (Write operations disabled in read-only mode)
manage-scheduled-transaction	Create, update, or delete a single scheduled (recurring) transaction. Use this to manage recurring bills or savings transfers. (Write operations disabled in…
list-payees	List all payees for a given budget. Good for finding payee IDs or identifying messy payee data that needs to be merged.
manage-payees	Merge multiple payee names into a single name. Use this to clean up payee data. (Write operations disabled in read-only mode)
lookup-entity-by-id	Look up the name and details of a specific account, category, or payee by its ID. A utility for when you have an ID but need the full context.
lookup-payee-locations	Look up geographic locations associated with a payee.
list-budgets	List all available YNAB budgets (Not available in single-budget mode).

How to install the ynab-mcp Server

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": [
        "ynab-mcp-server"
      ],
      "env": {
        "YNAB_PAT": "your_token_here"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.