YNAB MCP Server

A Model Context Protocol (MCP) server for seamless integration with You Need A Budget (YNAB). This server enables AI assistants to interact with your YNAB budgets, providing powerful automation and analysis capabilities.

Quick Installation (Claude Desktop)

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here",
      }
    }
  }
}

Optional environment variables:

"env": {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

Features

• Complete Budget Management

  • View and manage multiple budgets
  • Track account balances and transactions
  • Monitor category spending and goals

• Transaction Control

  • List and search transactions
  • Update transaction details
  • Manage payees and categories

• Financial Analysis

  • Get comprehensive financial overviews
  • Track spending patterns
  • Monitor budget progress

Table of Contents

• Installation
• Platform-Specific Setup
• Configuration
• Available Tools
• Usage Examples
• Development
• Contributing
• License

Installation & Usage

No installation needed when using uvx:

# Run directly (recommended)
uvx ynab-mcp-server

# Or with specific version
uvx [email protected]

For development:

# Clone and run from source
git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server
uv run ynab-mcp-server

Platform-Specific Setup

Claude Desktop

1. Locate your configuration file:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the YNAB MCP server configuration:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here"
      }
    }
  }
}

Optional environment variables:

env: {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

Goose

1. Open Goose settings
2. Navigate to the MCP Servers section
3. Add a new server with:
   • Name: ynab-mcp
   • Command: uvx ynab-mcp-server
   • Environment Variables:
     • YNAB_PAT: your_token_here

Other Platforms

For other MCP-compatible platforms, configure using these parameters:

• Server Name: ynab-mcp
• Command: uvx
• Arguments: ynab-mcp-server
• Required Environment Variable: YNAB_PAT

Configuration