Skip to main content
Glama
YNAB MCP Server

YNAB MCP Server

by rgarcia

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
YNAB_API_TOKENYesYour 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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 budgeted (assigned) amount can be updated.

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 transaction object, a single transaction will be created and if you provide a body containing a transactions array, multiple transactions will be created. Scheduled transactions (transactions with a future date) cannot be created on this endpoint.

updateTransactionsC

Updates multiple transactions, by id or import_id.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.7/5.0

Scored across 41 tools

Disambiguation4/5

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.

Naming Consistency4/5

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'.

Tool Count3/5

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.

Completeness3/5

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).

Maintenance

ActivityMaintained
ResponsivenessLimited data