An MCP server for the YNAB (You Need A Budget) API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"ynab-mcp-tools","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# YNAB MCP Server An MCP (Model Context Protocol) server for the [YNAB (You Need A Budget)](https://www.ynab.com/) API, built with [FastMCP](https://gofastmcp.com/). This server automatically exposes all YNAB API endpoints as MCP tools, allowing AI assistants like Claude to interact with your YNAB budgets, accounts, transactions, and more. ## Prerequisites - [uv](https://docs.astral.sh/uv/) package manager - A YNAB account with API access ## Setup ### Get Your YNAB API Token 1. Log in to your YNAB account at [app.ynab.com](https://app.ynab.com) 2. Go to **Account Settings** → **Developer Settings** 3. Click **New Token** under "Personal Access Tokens" 4. Give your token a name and click **Generate** 5. Copy the token (you won't be able to see it again!) ## Add the Server to Your MCP Client The published package runs with `uvx ynab-mcp-tools`. `uvx` downloads it from PyPI and runs it in an isolated environment, so you do not need to clone this repository or manage a virtualenv. ### With Claude Desktop Add the following to your Claude Desktop configuration file: **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "ynab": { "command": "uvx", "args": ["ynab-mcp-tools"], "env": { "YNAB_API_TOKEN": "your-token-here" } } } } ``` ### With Claude Code Use [Claude Code](https://code.claude.com/docs/en/mcp)'s MCP CLI. The `--` separates Claude's options from the server command. For all projects (**user** scope): ```bash claude mcp add ynab --scope user \ -e "YNAB_API_TOKEN=your-token-here" \ -- uvx ynab-mcp-tools ``` For the current directory only, omit `--scope user` or use `--scope local`. Use `claude mcp list` to verify and `claude mcp remove ynab --scope user` (or `local`) to uninstall. ### With Cursor Add the following to your Cursor MCP settings (`~/.cursor/mcp.json` for global or `.cursor/mcp.j…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.