MCP Server for YNAB MCP Server

An MCP server that exposes the YNAB API as tools, then adds enriched tools answering questions the raw API cannot answer in one call — budget health, cleanup queues, spending analysis, recurring…

Local serverstdio

What is the MCP Server for YNAB MCP Server?

mcp-server-for-ynab is an MCP project maintained in the hs737/mcp-server-for-ynab repository. The maintainer describes its purpose as “An MCP server that exposes the YNAB API as tools, then adds enriched tools answering questions the raw API cannot answer in one call —…”. Read the project documentation for the complete scope.

Installation

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

Configuration values

The example declares YNAB_API_KEY, YNAB_PLAN_ID. 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
Family	Type
overview	enriched
triage	enriched
bookkeeping	enriched
analysis	enriched
reconcile	enriched
history	enriched
changes	enriched
user	raw
plans	raw
accounts	raw
categories	raw
months	raw
payees	raw
payee_locations	raw
transactions	raw
scheduled_transactions	raw
money_movements	raw

How to install the MCP Server for YNAB MCP Server

{
  "mcpServers": {
    "ynab": {
      "command": "uvx",
      "args": [
        "mcp-server-for-ynab",
        "stdio"
      ],
      "env": {
        "YNAB_API_KEY": "YOUR_YNAB_API_KEY",
        "YNAB_PLAN_ID": "your_plan_id"
      }
    }
  }
}

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

Configuration

Variable	Description	Required
YNAB_API_KEY	Declared in the maintainer’s client configuration.	Check documentation
YNAB_PLAN_ID	Declared in the maintainer’s client configuration.	Optional