YNAB MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YNAB_API_TOKEN | Yes | Your YNAB API token |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| getUserB | Returns authenticated user information |
| getPlansC | Returns plans list with summary information |
| getPlanSettingsByIdB | Returns settings for a plan |
| getAccountsC | Returns all accounts |
| createAccountC | Creates a new account |
| getAccountByIdC | Returns a single account |
| getCategoriesA | Returns all categories grouped by category group. Amounts (assigned, activity, available, etc.) are specific to the current plan month (UTC). |
| createCategoryC | Creates a new category |
| getCategoryByIdB | Returns a single category. Amounts (assigned, activity, available, etc.) are specific to the current plan month (UTC). |
| updateCategoryD | Update a category |
| getMonthCategoryByIdA | Returns a single category for a specific plan month. Amounts (assigned, activity, available, etc.) are specific to the current plan month (UTC). |
| updateMonthCategoryC | Update a category for a specific month. Only |
| createCategoryGroupC | Creates a new category group |
| updateCategoryGroupD | Update a category group |
| createPayeeC | Creates a new payee |
| getPayeeByIdC | Returns a single payee |
| updatePayeeD | Update a payee |
| getPayeeLocationsC | Returns all payee locations |
| getPayeeLocationByIdC | Returns a single payee location |
| getPayeeLocationsByPayeeC | Returns all payee locations for a specified payee |
| getPlanMonthsC | Returns all plan months |
| getPlanMonthC | Returns a single plan month |
| getMoneyMovementsC | Returns all money movements |
| getMoneyMovementsByMonthB | Returns all money movements for a specific month |
| getMoneyMovementGroupsC | Returns all money movement groups |
| getMoneyMovementGroupsByMonthC | Returns all money movement groups for a specific month |
| getTransactionsA | Returns plan transactions, excluding any pending transactions IMPORTANT: this can return thousands of transactions and overflow your context. Always pass since_date (and until_date when you know it) covering only the dates you need, such as the last 7 to 30 days. Without since_date, YNAB returns a full year. Pass type="unapproved" or type="uncategorized" when you only need those transactions. |
| createTransactionA | Creates a single transaction or multiple transactions. If you provide a body containing a |
| updateTransactionsC | Updates multiple transactions, by |
| getTransactionByIdC | Returns a single transaction |
| updateTransactionC | Updates a single transaction |
| deleteTransactionD | Deletes a transaction |
| getTransactionsByAccountA | Returns all transactions for a specified account, excluding any pending transactions IMPORTANT: this can return thousands of transactions and overflow your context. Always pass since_date (and until_date when you know it) covering only the dates you need, such as the last 7 to 30 days. Without since_date, YNAB returns a full year. Pass type="unapproved" or type="uncategorized" when you only need those transactions. |
| getTransactionsByCategoryA | Returns all transactions for a specified category, excluding any pending transactions IMPORTANT: this can return thousands of transactions and overflow your context. Always pass since_date (and until_date when you know it) covering only the dates you need, such as the last 7 to 30 days. Without since_date, YNAB returns a full year. Pass type="unapproved" or type="uncategorized" when you only need those transactions. |
| getTransactionsByPayeeA | Returns all transactions for a specified payee, excluding any pending transactions IMPORTANT: this can return thousands of transactions and overflow your context. Always pass since_date (and until_date when you know it) covering only the dates you need, such as the last 7 to 30 days. Without since_date, YNAB returns a full year. Pass type="unapproved" or type="uncategorized" when you only need those transactions. |
| getTransactionsByMonthA | Returns all transactions for a specified month, excluding any pending transactions IMPORTANT: this can return thousands of transactions and overflow your context. Always pass since_date (and until_date when you know it) covering only the dates you need, such as the last 7 to 30 days. Without since_date, YNAB returns a full year. Pass type="unapproved" or type="uncategorized" when you only need those transactions. |
| getScheduledTransactionsC | Returns all scheduled transactions |
| createScheduledTransactionC | Creates a single scheduled transaction (a transaction with a future date). |
| getScheduledTransactionByIdB | Returns a single scheduled transaction |
| updateScheduledTransactionD | Updates a single scheduled transaction |
| deleteScheduledTransactionC | Deletes a scheduled transaction |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 41 tools
Most tools target a distinct resource+action pair, and the transaction-scoped variants (byAccount, byCategory, byPayee, byMonth) are meaningfully differentiated by their filter. Some overlap remains between getTransactions and its filtered siblings, and the PlanMonth/MonthCategory/money-movement cluster (getPlanMonth, getMonthCategoryById, getMoneyMovementsByMonth) requires careful reading to pick correctly.
Names follow a predictable camelCase verb_noun pattern (get*/update*/create*/delete* + resource), including plural forms for bulk operations (updateTransactions vs updateTransaction). Minor inconsistency in resource vocabulary: the same concept is called 'PlanMonth' in getPlanMonth(s) but 'MonthCategory' in getMonthCategoryById, and 'Plans' vs 'planSettings'.
41 tools is heavy for an agent-facing surface and exceeds the comfortable range, though it largely mirrors the breadth of the underlying YNAB API across accounts, transactions, categories, payees, scheduled transactions, months, and money movements. A few areas (four money-movement tools, three payee-location tools) look like thin API passthroughs rather than earn-your-place tools.
Transactions have full lifecycle coverage, but the surface is uneven elsewhere: there is no way to list payees (only getPayeeById), and no delete operations for accounts, categories, category groups, or payees, so agents can create resources they cannot clean up. Some lookups are also missing (e.g. money movement by id, scheduled transactions filtered by account).