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, payees, and months
  • Get single-resource details (account, category, payee, transaction)
  • Create, update, and delete transactions (single and bulk)
  • Update category budgets and metadata
  • Rename payees
  • Manage scheduled transactions (full CRUD)
  • Budget settings and user info

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:

Project Language License
calebl/ynab-mcp-server TypeScript MIT
mattweg/ynab-mcp JavaScript MIT
chrisguidry/you-need-an-mcp Python No license
py-ynab-mcp Python MIT

We wanted an MIT-licensed Python implementation with full API coverage and thorough test coverage. At the time of writing, the only Python option had no OSS license, so we built this one.

YNAB API Coverage

Read

  • User info, budget settings
  • Budgets, accounts, categories, payees, months (list and single)
  • Transactions with filtering by account, category, or payee
  • Scheduled transactions (list and single)

Write

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

Not available in YNAB API

  • Create/delete budgets, categories, or accounts
  • Create/delete payees (auto-created via transactions)
  • Transaction import

Development

# Clone and install
git clone https://github.com/duganth/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

Project links

Data verified by PyPI on Aug 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for duganth1 from gravatar.com duganth1

Credits

Author: duges

GitHub Statistics

Data verified by PyPI on Aug 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

budget finance mcp ynab

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py_ynab_mcp-0.2.1.tar.gz (111.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

py_ynab_mcp-0.2.1-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

Details for the file py_ynab_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: py_ynab_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 111.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for py_ynab_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 94a1e17ba7abe1f20370bf960d1a80f93bb5c1f9e5127c74bb18ee34365892f9
MD5 1f1e4ed61360a75c67102fd98e9dc8a7
BLAKE2b-256 c77ac0b1b513bf2a83490e483a2cbebb766cf4103b560c56a27131fb8df5167f

See more details on using hashes here.

Provenance

The following attestation bundles were made for py_ynab_mcp-0.2.1.tar.gz:

Publisher: publish.yml on duganth/py-ynab-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file py_ynab_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: py_ynab_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 18.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for py_ynab_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d4c00b9e02d327ccd98e9f8a37ec3d132953f19532d95c21c701ea4c78ecf462
MD5 d7463ca7bc689e0cbcc3757a0e0df85e
BLAKE2b-256 8cbdf2686bf1538cda25256adf430ef96ef2805e0be4c6b922dc44a03d862f6a

See more details on using hashes here.

Provenance

The following attestation bundles were made for py_ynab_mcp-0.2.1-py3-none-any.whl:

Publisher: publish.yml on duganth/py-ynab-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.3.0

2 files

This release

0.2.1 This release

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page