v0.3.3

Installation

npm

npx ynab-mcp-server
# or install globally
npm install -g ynab-mcp-server@0.3.3

Docker

docker pull ghcr.io/auzroz/ynab-mcp:0.3.3
docker run -e YNAB_ACCESS_TOKEN=your_token ghcr.io/auzroz/ynab-mcp:0.3.3

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      "args": ["ynab-mcp-server"],
      "env": { "YNAB_ACCESS_TOKEN": "your_token" }
    }
  }
}

Skills

This release also attaches a standalone YNAB best-practices skills
library —
15 Claude Agent Skills, downloadable below (ynab-mcp-skills-v0.3.3.zip
for the full bundle, or grab an individual skill's zip). Install via
Claude.ai → Settings → Capabilities → Skills → Upload skill, or drop
into a Claude Code skills directory. See
skills/README.md
for details — 7 work with this MCP server connected, 8 work standalone.

What's Changed

• feat: add MCP Prompts and a standalone YNAB best-practices skills library by @auzroz in #12

Full Changelog: v0.3.2...v0.3.3

v0.3.2

Installation

npm

npx ynab-mcp-server
# or install globally
npm install -g ynab-mcp-server@0.3.2

Docker

docker pull ghcr.io/auzroz/ynab-mcp:0.3.2
docker run -e YNAB_ACCESS_TOKEN=your_token ghcr.io/auzroz/ynab-mcp:0.3.2

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      "args": ["ynab-mcp-server"],
      "env": { "YNAB_ACCESS_TOKEN": "your_token" }
    }
  }
}

What's Changed

• Revert direct-to-main trust-proxy commit by @auzroz in #10
• fix: add TRUST_PROXY config to fix rate-limit X-Forwarded-For validation by @auzroz in #11

Full Changelog: v0.3.1...v0.3.2

v0.3.1

Installation

npm

npx ynab-mcp-server
# or install globally
npm install -g ynab-mcp-server@0.3.1

Docker

docker pull ghcr.io/auzroz/ynab-mcp:0.3.1
docker run -e YNAB_ACCESS_TOKEN=your_token ghcr.io/auzroz/ynab-mcp:0.3.1

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      "args": ["ynab-mcp-server"],
      "env": { "YNAB_ACCESS_TOKEN": "your_token" }
    }
  }
}

Full Changelog: v0.3.0...v0.3.1

v0.3.0

Installation

npm

npx ynab-mcp-server
# or install globally
npm install -g ynab-mcp-server@0.3.0

Docker

docker pull ghcr.io/auzroz/ynab-mcp:0.3.0
docker run -e YNAB_ACCESS_TOKEN=your_token ghcr.io/auzroz/ynab-mcp:0.3.0

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      "args": ["ynab-mcp-server"],
      "env": { "YNAB_ACCESS_TOKEN": "your_token" }
    }
  }
}

What's Changed

• test: comprehensive handler coverage, restore 80% gate by @auzroz in #7
• feat: remote multi-user MCP server with YNAB OAuth (v0.3.0) by @auzroz in #8
• docs: refresh README/.env for shipped multi-user OAuth (0.3.0) by @auzroz in #9

Full Changelog: v0.2.0...v0.3.0

v0.2.0

Installation

npm

npx ynab-mcp-server
# or install globally
npm install -g ynab-mcp-server@0.2.0

Docker

docker pull ghcr.io/auzroz/ynab-mcp:0.2.0
docker run -e YNAB_ACCESS_TOKEN=your_token ghcr.io/auzroz/ynab-mcp:0.2.0

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      "args": ["ynab-mcp-server"],
      "env": { "YNAB_ACCESS_TOKEN": "your_token" }
    }
  }
}

What's Changed

• Upgrade to ynab SDK v4, add new tools, fix version/coverage/security by @auzroz in #6

Full Changelog: v0.1.3...v0.2.0

v0.1.3

Installation

npm

npx ynab-mcp-server
# or install globally
npm install -g ynab-mcp-server@0.1.3

Docker

docker pull ghcr.io/auzroz/ynab-mcp:0.1.3
docker run -e YNAB_ACCESS_TOKEN=your_token ghcr.io/auzroz/ynab-mcp:0.1.3

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      "args": ["ynab-mcp-server"],
      "env": { "YNAB_ACCESS_TOKEN": "your_token" }
    }
  }
}

Full Changelog: v0.1.2...v0.1.3

v0.1.0 - Initial Release

YNAB MCP Server v0.1.0

The first public release of a comprehensive Model Context Protocol (MCP) server for YNAB (You Need A Budget). Enables AI assistants like Claude Desktop to interact with your budget through natural conversation.

✨ Highlights

• 55 MCP Tools covering 100% of the YNAB API plus custom analytics
• Safe by default with read-only mode enabled out of the box
• Smart rate limiting with token bucket algorithm (stays within YNAB's 200 req/hour limit)
• Intelligent caching to minimize API calls

📊 Analytics Tools (22)

Go beyond basic budgeting with AI-powered insights:

• Subscription Detection - Automatically identify recurring payments and subscriptions
• Spending Analysis - Category breakdowns and trend analysis
• Budget Health Score - Overall assessment with actionable alerts
• Savings Opportunities - Find areas to cut back
• Cash Flow Forecasting - Project future balances based on scheduled transactions
• Net Worth Tracking - Calculate total assets minus liabilities
• Goal Progress - Track funding status with projections
• And 15 more analytical tools...

🔧 Core API Coverage

Full coverage of YNAB API endpoints:

Category	Tools
Budgets	3
Accounts	3
Categories	4
Transactions	10
Payees	5
Scheduled Transactions	2
Months	2
User	1
System	3

🚀 Getting Started

Prerequisites

• Node.js 20+
• YNAB Personal Access Token (get one here)

Installation

git clone https://github.com/auzroz/ynab-mcp.git
cd ynab-mcp
npm install
cp .env.example .env
# Add your YNAB_ACCESS_TOKEN to .env
npm run build
npm start

Claude Desktop Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "ynab": {
      "command": "node",
      "args": ["/path/to/ynab-mcp/dist/index.js"],
      "env": {
        "YNAB_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

🔒 Security

• Read-only by default - Set YNAB_READ_ONLY=false to enable write operations
• Input validation - All parameters validated with Zod schemas
• Rate limit protection - Built-in safeguards against API quota exhaustion

📝 Example Prompts

Once connected, try asking Claude:

• "What's my current net worth?"
• "How much did I spend on dining out this month?"
• "What subscriptions do I have?"
• "Is my budget in good shape?"
• "Where can I cut back on spending?"

📋 Requirements

• Node.js 20 or later
• YNAB account with API access

---

Full Changelog: https://github.com/auzroz/ynab-mcp/commits/v0.1.0