py-ynab-mcp 0.1.0

A Model Context Protocol server for YNAB (You Need A Budget)

py-ynab-mcp

A Model Context Protocol server for YNAB (You Need A Budget). Talk to your budget from Claude, Cursor, or any MCP client.

Features

• Query budgets, accounts, categories, transactions, and more
• Create, update, and delete transactions
• Update category budgets and move money
• Manage scheduled transactions
• Delta sync support to minimize API calls

Install

uvx py-ynab-mcp

Or with pip:

pip install py-ynab-mcp

Setup

1. Get a YNAB Personal Access Token
2. Add to your MCP client config:

{
  "mcpServers": {
    "ynab": {
      "command": "uvx",
      "args": ["py-ynab-mcp"],
      "env": {
        "YNAB_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Why this project?

There are several YNAB MCP servers out there. Here's why we built another one:

Project	Language	Notes
calebl/ynab-mcp-server	TypeScript	Full CRUD, but inconsistent code quality
mattweg/ynab-mcp	JavaScript	Has known bugs (amount parsing), dormant since mid-2025
chrisguidry/you-need-an-mcp	Python	Excellent code quality, but no OSS license
py-ynab-mcp	Python	MIT licensed, full API coverage, actively maintained

We wanted a Python MCP server for YNAB that is properly licensed, well-tested, and covers the full YNAB API — including write operations for transaction management. The best existing implementation had no license, making it unsuitable for use or contribution. So here we are.

YNAB API Coverage

Read

• Budgets, accounts, categories, payees, months
• Transactions (with filtering by account, category, payee, date)
• Scheduled transactions
• Delta sync on supported endpoints

Write

• Create, update, delete transactions (single and bulk)
• Update category budgets
• Create accounts
• Create, update, delete scheduled transactions
• Update payees

Not supported by YNAB API

• Creating budgets, categories, or payees (must be done in the YNAB app)

Development

# Clone and install
git clone https://github.com/duges/py-ynab-mcp.git
cd py-ynab-mcp
uv sync

# Run tests
uv run pytest

# Lint and type check
uv run ruff check .
uv run mypy src/

License

MIT