YNAB MCP

@EthanKang1

About YNAB MCP

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": [
        "run",
        "ynab-mcp"
      ],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is YNAB MCP?

YNAB MCP is a Model Context Protocol server for interacting with YNAB (You Need A Budget). It provides tools for accessing budget data through MCP-enabled clients like Claude Desktop.

How to use YNAB MCP?

Add a configuration entry to your MCP client’s settings (e.g., cline_mcp_settings.json) using the command uvx with arguments ["run", "ynab-mcp"] and the environment variable YNAB_API_KEY. For advanced setups, you can run from a specific directory using uv. Debugging is supported via the MCP Inspector.

Key features of YNAB MCP

Retrieve authenticated user information (GetUser).
List all accessible budgets with IDs and names (ListBudgets).
Get detailed budget info, including transactions and balances (GetBudget).
Fetch all categories defined in a budget (GetBudgetCategories).
Retrieve budget settings like currency and date formats (GetBudgetSettings).

Use cases of YNAB MCP

Automate budget data retrieval for personal finance analysis.
Integrate YNAB data into AI-powered assistants for spending insights.
Quickly look up category balances and transaction history.
Validate budget configurations across multiple budgets.
Build custom budgeting workflows without manual YNAB API calls.

FAQ from YNAB MCP

What configuration is required to use YNAB MCP?

You need a valid YNAB API key set as the YNAB_API_KEY environment variable, and the server is launched via uvx run ynab-mcp in your MCP client configuration.

How are monetary amounts returned?

All monetary amounts are returned in milliunits (e.g., 1000 = $1.00). Divide by 1000 to convert to standard currency units.

What data does the GetBudget tool return?

It returns detailed information about a specific budget, including transactions, categories, and balances. It also supports optional date filtering and transaction limiting.

How can I debug YNAB MCP?

Use the MCP Inspector by installing it via npm and updating your configuration to run the inspector alongside the server. It provides real-time logs, request/response inspection, tool schema validation, and an interactive testing interface.

Is there a limit on the number of transactions returned?

The GetBudget tool supports an optional transaction limit parameter, but the README does not specify a default or maximum limit.

Frequently asked questions

What configuration is required to use YNAB MCP?

You need a valid YNAB API key set as the `YNAB_API_KEY` environment variable, and the server is launched via `uvx run ynab-mcp` in your MCP client configuration.

How are monetary amounts returned?

All monetary amounts are returned in milliunits (e.g., 1000 = $1.00). Divide by 1000 to convert to standard currency units.

What data does the GetBudget tool return?

It returns detailed information about a specific budget, including transactions, categories, and balances. It also supports optional date filtering and transaction limiting.

How can I debug YNAB MCP?

Is there a limit on the number of transactions returned?

The GetBudget tool supports an optional transaction limit parameter, but the README does not specify a default or maximum limit.

Comments

Basic information

More Other MCP servers

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Mobile Mcp

mobile-next

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)

5.4K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

ICSS

chokcoco

不止于 CSS

20.7K