ynab-mcp

MIT License

YNAB MCP Server

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

MCP Client Configuration

Basic Configuration

Add this to your MCP client's configuration (e.g. cline_mcp_settings.json for Claude Desktop):

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

Advanced Configuration

If you're running from a specific directory:

{ "mcpServers": { "ynab-mcp": { "command": "uv", "args": ["--directory", "/path/to/ynab-mcp", "run", "ynab-mcp"], "env": { "YNAB_API_KEY": "your-api-key-here" } } } }

Debugging

To debug with the MCP Inspector:

  1. Install the inspector:
npm install -g @modelcontextprotocol/inspector
  1. Update your configuration to use the inspector with uv:
{ "mcpServers": { "ynab-mcp": { "command": "uv", "args": ["--directory", "/path/to/ynab-mcp", "run", "@modelcontextprotocol/inspector", "ynab-mcp"], "env": { "YNAB_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": [] } } }

The inspector provides:

  • Real-time logs of tool calls and responses
  • Request/response inspection
  • Tool schema validation
  • Interactive testing interface

Available Tools

GetUser

Retrieves information about the authenticated YNAB user, including user ID and email.

ListBudgets

Lists all budgets accessible to the authenticated user, including budget IDs and names.

GetBudget

Retrieves detailed information about a specific budget, including transactions, categories, and balances. Supports optional date filtering and transaction limiting.

Note: Monetary amounts are returned in milliunits (e.g., 1000 = $1.00)

GetBudgetCategories

Retrieves all categories defined in the specified budget, including category groups, names, and IDs.

GetBudgetSettings

Retrieves settings for the specified budget, including currency format, date format, and other preferences.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. MCP Client Configuration
    1. Basic Configuration
    2. Advanced Configuration
    3. Debugging
  2. Available Tools
    1. GetUser
    2. ListBudgets
    3. GetBudget
    4. GetBudgetCategories
    5. GetBudgetSettings

Related MCP Servers

  • A
    security
    F
    license
    A
    quality
    An MCP server that allows users to interact with YNAB data, enabling access to account balances, transactions, and the creation of new transactions through the Model Context Protocol.
    Last updated -
    10
    1
    Python
  • -
    security
    F
    license
    -
    quality
    Provides access to YNAB (You Need A Budget) functionality through the Model Context Protocol, allowing users to view account balances, access transaction data, and create new transactions.
    Last updated -
    Python
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that enables AI-powered interaction with YNAB (You Need A Budget) data, allowing users to query their budgets through conversational interfaces.
    Last updated -
    1
    15
    1
    TypeScript
    MIT License
    • Apple
  • -
    security
    A
    license
    -
    quality
    A hub server that connects to and manages other MCP (Model Context Protocol) servers.
    Last updated -
    181
    4
    TypeScript
    MIT License

View all related MCP servers

ID: np8t56h8d3