Skip to content
Back to search

ynab-mcp-server

YNAB MCP server with custom skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/rgarcia/ynab-mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/rgarcia/ynab-mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rgarcia--ynab-mcp-server/badge.svg)](/listings/rgarcia--ynab-mcp-server)

HTML

<a href="/listings/rgarcia--ynab-mcp-server"><img src="/api/listings/rgarcia--ynab-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 127 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # YNAB MCP Server
  2. An [MCP](https://modelcontextprotocol.io/) server for the [YNAB](https://www.ynab.com/) API, built with [FastMCP](https://gofastmcp.com/).
  3. Tools are generated at startup from YNAB's published OpenAPI spec, so new YNAB endpoints show up without a new release of this package.
  4. ## Setup
  5. 1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/).
  6. 2. Create a YNAB personal access token at [app.ynab.com/settings/developer](https://app.ynab.com/settings/developer) (**New Token**). Copy it right away; YNAB only shows it once.
  7. 3. Add the server to your MCP client using one of the snippets below, replacing `your-token-here` with your token.
  8. Every snippet runs `uvx ynab-mcp-tools`, which downloads the package from PyPI and runs it in an isolated environment. You don't need to clone this repository.
  9. ### Claude Code
  10. ```bash
  11. claude mcp add ynab --scope user \
  12. -e "YNAB_API_TOKEN=your-token-here" \
  13. -- uvx ynab-mcp-tools
  14. ```
  15. Drop `--scope user` to add it to the current project only. See the [Claude Code MCP docs](https://code.claude.com/docs/en/mcp).
  16. ### Codex
  17. ```bash
  18. codex mcp add ynab \
  19. --env "YNAB_API_TOKEN=your-token-here" \
  20. -- uvx ynab-mcp-tools
  21. ```
  22. ### Claude Desktop and Cursor
  23. Both use the same JSON. Add it to:
  24. - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
  25. - **Cursor**: `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project)
  26. ```json
  27. {
  28. "mcpServers": {
  29. "ynab": {
  30. "command": "uvx",
  31. "args": ["ynab-mcp-tools"],
  32. "env": {
  33. "YNAB_API_TOKEN": "your-token-here"
  34. }
  35. }
  36. }
  37. }
  38. ```
  39. To find the Claude Desktop config file without typing the path, open **Settings → Desktop App → Extensions (Manage) → Local MCP Servers → Edit Config**. Finder opens with the file selected. On macOS, right-click it and choose **Open With → TextEdit**, paste the JSON above, save, then quit and reopen Claude Desktop.
  40. ### ChatGPT desktop app
  41. 1. Open **Settings**, search for "MCP", and click **MCPs / Plugins**.
  42. 2. Click **Add → Add MCP Server** and fill in:
  43. - **Name**: `YNAB`
  44. - **Command to launch**: `uvx`
  45. - **Arguments**: `ynab-mcp-tools`
  46. - **Environment Variables**: key `YNAB_API_TOKEN`, value `your-token-here`
  47. If a desktop app reports that it can't find `uvx`, replace `uvx` with the full path printed by `which uvx` in a terminal (usually `~/.local/bin/uvx`, written out as `/Users/<you>/.local/bin/uvx`).
  48. ### OpenCode
  49. Add to `~/.config/opencode/opencode.json`:
  50. ```json
  51. {
  52. "mcp": {
  53. "servers": {
  54. "ynab": {
  55. "type": "local",
  56. "command": ["uvx", "ynab-mcp-tools"],
  57. "environment": {
  58. "YNAB_API_TOKEN": "your-token-here"
  59. }
  60. }
  61. }
  62. }
  63. }
  64. ```
  65. ## Tools
  66. YNAB's API now calls budgets **plans**, so tools and parameters use that name (`getPlans`, `plan_id`). Pass `last-used` as the `plan_id` to target your most recently opened plan.
  67. | Area | Tools |
  68. | --- | --- |
  69. | User | `getUser` |
  70. | Plans | `getPlans`, `getPlanSettingsById` |
  71. | Accounts | `getAccounts`, `getAccountById`, `createAccount` |
  72. | Categories | `getCategories`, `getCategoryById`, `createCategory`, `updateCategory`, `getMonthCategoryById`, `updateMonthCategory`, `createCategoryGroup`, `updateCategoryGroup` |
  73. | Payees | `getPayeeById`, `createPayee`, `updatePayee`, `getPayeeLocations`, `getPayeeLocationById`, `getPayeeLocationsByPayee` |
  74. | Months | `getPlanMonths`, `getPlanMonth` |
  75. | Money movements | `getMoneyMovements`, `getMoneyMovementsByMonth`, `getMoneyMovementGroups`, `getMoneyMovementGroupsByMonth` |
  76. | Transactions | `getTransactions`, `getTransactionById`, `createTransaction`, `updateTransaction`, `updateTransactions`, `deleteTransaction`, `getTransactionsByAccount`, `getTransactionsByCategory`, `getTransactionsByPayee`, `getTransactionsByMonth` |
  77. | Scheduled transactions | `getScheduledTransactions`, `getScheduledTransactionById`, `createScheduledTransaction`, `updateScheduledTransaction`, `deleteScheduledTransaction` |
  78. Two kinds of endpoints are left out on purpose:
  79. - `getPlanById` and `getPayees`: these return an entire plan export or the full payee list, which is too large for a model's context. The narrower tools above cover the same data.
  80. - Endpoints YNAB marks deprecated, such as `importTransactions`, which YNAB now accepts but ignores.
  81. YNAB's API has no pagination. The transaction list tools tell the model to pass `since_date`, `until_date`, or `type`, and if a transaction list still comes back over 200,000 characters, the tool returns an error asking the model to retry with a narrower range.
  82. ## Example prompts
  83. - "Show me my unapproved transactions from the last two weeks."
  84. - "How much have I spent on dining out this month compared to last month?"
  85. - "Categorize my uncategorized transactions, and ask me about anything ambiguous."
  86. - "Move $50 from Vacation to Groceries for this month."
  87. To make your own conventions stick between sessions (how you handle Venmo duplicates, which payees map to which categories), write them into your client's skills or rules, for example a [Claude skill](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview).
  88. ## Resources
  89. - [Development guide](https://github.com/rgarcia/ynab-mcp-server/blob/main/DEVELOPMENT.md)
  90. - [YNAB API documentation](https://api.ynab.com/)
  91. - [FastMCP documentation](https://gofastmcp.com/)
  92. ## License
  93. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.