ynab-mcpb
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YNAB_EXPORT_PATH | No | Optional directory for exported transaction files. | |
| YNAB_ACCESS_TOKEN | Yes | Your YNAB personal access token, obtained from Account Settings -> Developer Settings in the YNAB Web App. | |
| YNAB_MCP_ENABLE_DELTA | No | Enable/disable delta sync optimization (defaults to 'true'). | true |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_budgetsA | List all budgets associated with the user's account |
| get_budgetB | Get detailed information for a specific budget |
| list_payeesB | List all payees for a specific budget |
| get_payeeB | Get detailed information for a specific payee |
| list_categoriesA | List all categories for a specific budget |
| get_categoryB | Get detailed information for a specific category |
| update_categoryB | Update the budgeted amount for a category in the current month |
| list_accountsB | List all accounts for a specific budget |
| get_accountA | Get detailed information for a specific account |
| create_accountB | Create a new account in the specified budget |
| get_monthB | Get budget data for a specific month |
| list_monthsA | List all months summary data for a budget |
| list_transactionsA | List transactions for a budget with optional filtering |
| export_transactionsB | Export all transactions to a JSON file with descriptive filename |
| get_transactionB | Get detailed information for a specific transaction |
| create_transactionB | Create a new transaction in the specified budget and account |
| create_transactionsA | Create multiple transactions in a single batch (1-100 items) with duplicate detection, dry-run validation, and automatic response size management with correlation metadata. |
| create_receipt_split_transactionA | Create a split transaction from receipt items with proportional tax allocation |
| update_transactionC | Update an existing transaction |
| update_transactionsA | Update multiple transactions in a single batch (1-100 items) with dry-run validation, automatic cache invalidation, and response size management. Supports optional original_account_id and original_date metadata for efficient cache invalidation. |
| delete_transactionA | Delete a transaction from the specified budget |
| compare_transactionsA | Compare bank transactions from CSV with YNAB transactions to find missing entries |
| reconcile_accountC | Guided reconciliation workflow with human narrative, insight detection, and optional execution (create/update/unclear). Set include_structured_data=true to also get full JSON output (large). |
| get_userA | Get information about the authenticated user |
| set_default_budgetB | Set the default budget for subsequent operations |
| get_default_budgetA | Get the currently set default budget |
| diagnostic_infoA | Get comprehensive diagnostic information about the MCP server |
| clear_cacheA | Clear the in-memory cache (safe, no YNAB data is modified) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| create-transaction | Create a new transaction in YNAB |
| budget-summary | Get a summary of your budget status |
| account-balances | Check balances across all accounts |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| YNAB Budgets | List of all available budgets |
| YNAB User Info | Current user information including ID and email address |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/dizzlkheinz/ynab-mcpb'
If you have feedback or need assistance with the MCP directory API, please join our Discord server