mcp-ynab
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TRANSPORT | No | Transport mode: http (default) or stdio | http |
| YNAB_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
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| getUserB | Returns authenticated user information |
| getPlansB | Returns plans list with summary information |
| getPlanByIdA | Returns a single plan with all related entities. This resource is effectively a full plan export. |
| getPlanSettingsByIdB | Returns settings for a plan |
| getAccountsC | Returns all accounts |
| createAccountD | Creates a new account |
| getAccountByIdB | 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). |
| createCategoryB | Creates a new category |
| getCategoryByIdA | Returns a single category. Amounts (assigned, activity, available, etc.) are specific to the current plan month (UTC). |
| updateCategoryC | 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). |
| updateMonthCategoryA | Update a category for a specific month. Only |
| createCategoryGroupC | Creates a new category group |
| updateCategoryGroupC | Update a category group |
| getPayeesB | Returns all payees |
| createPayeeC | Creates a new payee |
| getPayeeByIdB | Returns a single payee |
| updatePayeeD | Update a payee |
| getPayeeLocationsB | Returns all payee locations |
| getPayeeLocationByIdC | Returns a single payee location |
| getPayeeLocationsByPayeeB | Returns all payee locations for a specified payee |
| getPlanMonthsC | Returns all plan months |
| getPlanMonthA | Returns a single plan month |
| getMoneyMovementsC | Returns all money movements |
| getMoneyMovementsByMonthA | Returns all money movements for a specific month |
| getMoneyMovementGroupsC | Returns all money movement groups |
| getMoneyMovementGroupsByMonthB | Returns all money movement groups for a specific month |
| getTransactionsB | Returns plan transactions, excluding any pending transactions |
| createTransactionA | Creates a single transaction or multiple transactions. If you provide a body containing a |
| updateTransactionsB | Updates multiple transactions, by |
| importTransactionsA | Imports available transactions on all linked accounts for the given plan. Linked accounts allow transactions to be imported directly from a specified financial institution and this endpoint initiates that import. Sending a request to this endpoint is the equivalent of clicking "Import" on each account in the web application or tapping the "New Transactions" banner in the mobile applications. The response for this endpoint contains the transaction ids that have been imported. |
| getTransactionByIdC | Returns a single transaction |
| updateTransactionC | Updates a single transaction |
| deleteTransactionC | Deletes a transaction |
| getTransactionsByAccountA | Returns all transactions for a specified account, excluding any pending transactions |
| getTransactionsByCategoryA | Returns all transactions for a specified category, excluding any pending transactions |
| getTransactionsByPayeeB | Returns all transactions for a specified payee, excluding any pending transactions |
| getTransactionsByMonthA | Returns all transactions for a specified month, excluding any pending transactions |
| getScheduledTransactionsC | Returns all scheduled transactions |
| createScheduledTransactionC | Creates a single scheduled transaction (a transaction with a future date). |
| getScheduledTransactionByIdA | Returns a single scheduled transaction |
| updateScheduledTransactionC | Updates a single scheduled transaction |
| deleteScheduledTransactionB | 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 44 tools
Each tool targets a distinct resource and action. Get, create, update, and delete operations are clearly separated per entity, and even similar tools like getCategoryById vs getMonthCategoryById are differentiated by their descriptions (month-specific vs current month). No two tools appear to do the same thing.
All tools follow a verb_noun camelCase pattern (getPlans, createAccount, updateTransaction). Minor deviations exist such as getPlanMonth vs getPlanMonths and some singular/plural inconsistencies, but the pattern is recognizable and predictable.
With 44 tools, this is far beyond the typical MCP server scope and feels bloated. While the domain (YNAB budgeting) is complex, the number of tools is excessive and would likely overwhelm an agent, making selection harder.
The tool surface covers transactions and categories thoroughly with full CRUD, but gaps exist: accounts lack update/delete, plans have no create/update, payee locations are read-only, and money movements have no write operations. These missing operations could hinder common budgeting workflows.