@oliverames/ynab-mcp-server

finance MCP Server

MCP server for YNAB (You Need A Budget) — full API coverage. Budget tracking, transaction categorization, account management, goal monitoring, and financial reporting through AI.

VerifiedInstall Ready
financefinance
2 views4 stars3 forksv1.7.1MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
4
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx @oliverames/ynab-mcp-server

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "-oliverames-ynab-mcp-server": {
      "command": "npx",
      "args": [
        "@oliverames/ynab-mcp-server"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

60
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (60)

Resource

Tools

8

Full CRUD, bulk ops, split transactions, multi-filter

get_budget_settings

Get currency and date format settings

list_categories

List all category groups and their categories with budgeted/activity/balance

create_category_group

Create a new category group

update_transactions

Batch update multiple transactions at once

delete_scheduled_transaction

Delete a scheduled transaction

YNAB_OP_PATH

No

9

Full CRUD, groups, search, goals, monthly budgets

get_category

Get full category details including goal progress and cadence

update_category_group

Rename a category group

list_money_movement_groups

List all money movement groups (batched re-allocations)

5

Full CRUD for recurring transactions

1

Unapproved transaction review workflow

list_accounts

List all accounts with balances, debt details, and import status

update_month_category

Set the budgeted amount for a category in a month

get_payee

Get payee details

get_payee_location

Get a specific payee location

list_money_movements

List all money movements (budget re-allocations between categories)

get_scheduled_transaction

Get a specific scheduled transaction

Tool

Description

search_categories

Case-insensitive partial name search (e.g., "groc" finds "Groceries")

search_payees

Case-insensitive partial name search

Variable

Required

Positive

`1000.00`

get_budget

Get budget summary (name, currency, account/category/payee counts)

create_category

Create a new category in an existing group (with optional goal)

update_payee

Rename a payee

list_months

List budget months with income, budgeted, activity, to-be-budgeted, age of money, and notes

get_transactions

Get transactions with filters: by account, category, payee, month, or status (`unapproved`/`uncategorized`)

delete_transaction

Delete a transaction

Direction

Sign

list_budgets

List all budgets with IDs, names, date ranges, format settings, and default budget

create_account

Create a new account (checking, savings, creditCard, mortgage, etc.)

update_category

Update name, note, goal target, goal target date, or move to a different group

create_payee

Create a new payee

get_payee_locations_by_payee

Get all locations for a specific payee

get_money_movements_by_month

Get money movements for a specific month

create_transactions

Bulk create multiple transactions in a single API call (supports split transactions)

4

Budget re-allocation tracking

get_month_category

Get category budget for a specific month

2

Monthly summaries with per-category breakdown

get_user

Get the authenticated user

get_account

Get full account details including notes and debt fields

get_money_movement_groups_by_month

Get money movement groups for a specific month

update_transaction

Partial update - only specified fields change

update_scheduled_transaction

Update (fetch-then-merge preserves unchanged fields)

3

GPS coordinates for mobile transactions

list_payees

List all payees with transfer account mappings

list_payee_locations

List all payee locations (GPS coordinates from mobile app)

create_transaction

Create a transaction with optional split (subtransactions must sum to total)

list_scheduled_transactions

List all recurring transactions

YNAB_API_TOKEN

Yes*

get_month

Get month detail with per-category budget/activity/balance/goal breakdown

get_transaction

Get a single transaction by ID (includes subtransactions). Auto-handles composite scheduled-transaction IDs like `uuid_YYYY-MM-DD`.

import_transactions

Trigger import from linked bank accounts

create_scheduled_transaction

Create a recurring transaction with frequency

YNAB_BUDGET_ID

No

review_unapproved

Get unapproved transactions grouped by readiness: "ready to approve" (categorized, split, or transfer) vs. "needs category first" (uncategorized). Each transaction includes a `flags` array highlighting anomalies (manually_entered, match_broken, no_prior_amount_match, category_drift, new_payee, scheduled_transaction_realized) computed against 60 days of payee history. Includes a warning against blind approval.

Negative

`-1000.00`