YNAB

YNAB

MCP server for integrating YNAB with AI systems, enabling secure analysis of financial data.

11
Stars
1
Forks
7
Releases

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.

Details

Owner
ChuckBryan
Language
C#
License
Updated
2025-12-07

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

Audience

AI developersUse MCP to connect AI assistants to YNAB data via the server for secure analysis and actionable insights.
YNAB usersRun the MCP server locally to enable AI-enabled querying of budgets, transactions, and financial insights while keeping API tokens private.

Tags

MCPYNABYou Need A BudgetFinanceBudgetingAISecurityData AccessLocal ServerDocker.NETMCP ServerYNAB API