# Ynab Mcp Server

> MCP server for YNAB (You Need A Budget) API. Connects Claude Code (or any MCP client) to your YNAB account for reading budgets, managing transactions, and tracking spending.

- **Type:** MCP server
- **Install:** `agentstack add mcp-rollecode-ynab-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [rollecode](https://agentstack.voostack.com/s/rollecode)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [rollecode](https://github.com/rollecode)
- **Source:** https://github.com/rollecode/ynab-mcp-server

## Install

```sh
agentstack add mcp-rollecode-ynab-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# YNAB MCP server

    

---

MCP server for [YNAB (You Need A Budget)](https://ynab.com) API. Connects Claude Code (or any MCP client) to your YNAB account for reading budgets, managing transactions, and tracking spending.

Built because existing YNAB MCP servers fetch entire transaction histories (8MB+) and time out on real-world budgets with years of data. This server uses proper date filtering and returns only what you need.

---

## Features

- Budget summary with daily allowance calculation
- List and filter transactions by date, category, payee, or account
- Create, update, and delete transactions via natural language
- Move money between categories
- View scheduled/recurring transactions
- Proper date filtering — no full history dumps

## Tools

| Tool | Description |
|------|-------------|
| `ynab_list_budgets` | List all budgets with IDs |
| `ynab_budget_summary` | Daily allowance, available by category, overspent categories |
| `ynab_list_accounts` | All accounts with balances |
| `ynab_list_categories` | Category groups with current month balances |
| `ynab_get_month` | Budget details for a specific month |
| `ynab_list_transactions` | Transactions filtered by date (defaults to current month, max 200) |
| `ynab_create_transaction` | Create expense or income |
| `ynab_update_transaction` | Update existing transaction |
| `ynab_delete_transaction` | Delete a transaction |
| `ynab_set_category_budget` | Set budgeted amount for a category (move money) |
| `ynab_list_payees` | List all payees |
| `ynab_list_scheduled` | Scheduled/recurring transactions |

## Setup

### 1. Get a YNAB Personal Access Token

Go to [YNAB Developer Settings](https://app.ynab.com/settings/developer) and create a Personal Access Token.

### 2. Configure

```bash
cp .env.example .env
```

Add your `YNAB_API_TOKEN` to `.env`.

### 3. Install and run

```bash
bun install
```

### 4. Add to Claude Code

```bash
claude mcp add ynab --transport stdio -- bun /path/to/ynab-mcp-server/server.ts
```

Or add to `.mcp.json` in your project:

```json
{
  "mcpServers": {
    "ynab": {
      "command": "bun",
      "args": ["/path/to/ynab-mcp-server/server.ts"],
      "env": {
        "YNAB_API_TOKEN": "your_token_here"
      }
    }
  }
}
```

### 5. Verify

In Claude Code, run `/mcp` and check that `ynab` shows as connected.

## Usage examples

- "What's my daily spending allowance?"
- "How much did I spend on groceries this month?"
- "Add 15 euros expense at Lidl for groceries"
- "Move 50 euros from Buffer to Groceries"
- "Show my scheduled transactions"
- "What categories are overspent?"

## Requirements

- [Bun](https://bun.sh) runtime
- YNAB account with API access

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [rollecode](https://github.com/rollecode)
- **Source:** [rollecode/ynab-mcp-server](https://github.com/rollecode/ynab-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-rollecode-ynab-mcp-server
- Seller: https://agentstack.voostack.com/s/rollecode
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.