Overview
YNAB MCP Server provides a local bridge between your YNAB data and MCP-compatible AI assistants. It enables secure, on-device access to YNAB information through a curated set of MCP tools, including user and budget discovery, budget details, category and transaction queries, account and payee listings, and several analytics endpoints. Specifically, you can GetUserInfo, ListBudgets, GetBudgetDetails, GetBudgetMonths, ListCategories, GetCategoryDetails, SearchTransactions, and GetCurrentMonthSnapshot. All data tokens remain local; the YNAB API token is not exposed to third parties. Prerequisites are a YNAB account with API access and an MCP-compatible client (e.g., Claude Desktop). The server can be run via Docker or locally with the .NET 9 SDK. Environment variable YNAB_API_TOKEN is used for authentication. The repository includes a typical project layout with configuration, generated API clients, services, and MCP tools, and guidance for extending by adding new MCP tools decorated with MCP attributes. The project is licensed under MIT and uses semantic-release for versioning, with a focus on secure, private access to budget data for AI-driven analysis and insights.
Features
GetUserInfo
Retrieve your YNAB user ID
ListBudgets
Get all budgets in your YNAB account
GetBudgetDetails
Detailed information about a specific budget
GetBudgetMonths
List budget months
ListCategories
All categories in a budget
GetCategoryDetails
Detailed information about a category
SearchTransactions
Find transactions with custom filters
GetCurrentMonthSnapshot
Summary of the current month's budget
Who Is This For?
- AI developers:Use MCP to connect AI assistants to YNAB data via the server for secure analysis and actionable insights.
- YNAB users:Run the MCP server locally to enable AI-enabled querying of budgets, transactions, and financial insights while keeping API tokens private.




