YNAB MCP Server

Example Use Cases

• 1

  Read a user's budgets and related metadata to provide budget-aware advice or summaries.

• 2

  Fetch transactions and balances (with optional date filtering and limits) to analyze recent spending or generate reports.

• 3

  Obtain budget category structures and settings (currency/date format) to present or transform budget data correctly.

Description

This project implements a Model Context Protocol (MCP) server to interact with YNAB using a user-provided YNAB API key. It exposes tools for retrieving user info, listing budgets, fetching detailed budget data (including transactions, categories, and balances), and reading budget settings. Tools support optional filtering (e.g., date ranges, transaction limits) and return monetary amounts in milliunits. It enables agents and MCP clients to integrate budget data into workflows and conversational assistants.