ynab-mcp

ynab-mcp

An MCP server that exposes the full YNAB API, allowing LLMs to read and manage budgets, accounts, and transactions through natural language. It features 49 specialized tools for comprehensive financial management, including category updates, money movements, and transaction tracking.

Category
Visit Server

README

ynab-mcp

An MCP (Model Context Protocol) server that exposes the full YNAB API, allowing LLMs to read and manage your budget through natural language.

Requirements

Installation

npm install -g ynab-mcp

Or install from source:

git clone https://github.com/justmytwospence/ynab-mcp.git
cd ynab-mcp
npm install
npm run build
npm install -g .

Configuration

Set your YNAB API token as an environment variable:

export YNAB_API_TOKEN="your-token-here"

Generate a token at YNAB > Account Settings > Developer Settings.

Claude Code

claude mcp add ynab-mcp ynab-mcp -e YNAB_API_TOKEN=your-token-here

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "ynab-mcp",
      "env": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Tools

49 tools covering the full YNAB API. All monetary amounts use YNAB's milliunits format (e.g., $12.34 = 12340).

User

Tool Description
get_user Get authenticated user info

Budgets

Tool Description
list_budgets List all budgets with optional account info
get_budget Get a budget's full detail including all entities
get_budget_settings Get date and currency format settings

Accounts

Tool Description
list_accounts List all accounts with balances and types
get_account Get details for a single account
create_account Create a new account

Categories

Tool Description
list_categories List all categories grouped by category group
get_category Get details for a single category
create_category Create a new category
update_category Update a category's name, note, or goal
get_month_category Get a category's budget for a specific month
update_month_category Update budgeted amount for a category in a month
create_category_group Create a new category group
update_category_group Update a category group's name

Transactions

Tool Description
list_transactions List transactions with optional filters
get_transaction Get details for a single transaction
create_transaction Create a new transaction
create_transactions Batch create multiple transactions
update_transaction Update an existing transaction
update_transactions Bulk update multiple transactions
delete_transaction Delete a transaction
import_transactions Import from linked financial institutions
list_account_transactions List transactions for a specific account
list_category_transactions List transactions for a specific category
list_payee_transactions List transactions for a specific payee
list_month_transactions List transactions for a specific month

Scheduled Transactions

Tool Description
list_scheduled_transactions List all scheduled/recurring transactions
get_scheduled_transaction Get details for a scheduled transaction
create_scheduled_transaction Create a new scheduled transaction
update_scheduled_transaction Update a scheduled transaction
delete_scheduled_transaction Delete a scheduled transaction

Payees

Tool Description
list_payees List all payees
get_payee Get details for a single payee
update_payee Update a payee's name

Payee Locations

Tool Description
list_payee_locations List all payee GPS locations
get_payee_location Get a single payee location
get_payee_locations_for_payee Get all locations for a specific payee

Months

Tool Description
list_months List all budget months with summaries
get_month Get detailed month info with category balances

Money Movements

Tool Description
list_money_movements List all money movements
get_month_money_movements Get money movements for a specific month
list_money_movement_groups List all money movement groups
get_month_money_movement_groups Get money movement groups for a specific month

Workflows

Tool Description
merge_category Merge a source category into a target, moving all transactions and budgeted amounts

Development

npm run dev    # Watch mode with tsx
npm run build  # Compile TypeScript
npm start      # Run compiled server

License

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured