Skip to main content
Glama
henfrydls

actual-budget-mcp

by henfrydls

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ACTUAL_DATA_DIRNoCache directory (default: /tmp/actual-budget-mcp-data)
ACTUAL_PASSWORDYesServer password (set in Actual Budget under Settings)
ACTUAL_BUDGET_IDYesBudget Sync ID (found in Settings > Show advanced settings)
ACTUAL_SERVER_URLYesYour Actual Budget server URL (e.g., http://localhost:5006)
ACTUAL_ENCRYPTION_PASSWORDNoOnly if your budget file is encrypted

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_accountsA

List all budget accounts with their current balances, type (on-budget/off-budget), and status.

get_budget_monthA

Get the budget for a specific month showing all category groups, their categories with budgeted amounts, actual spending, and remaining balance. Also shows the to-be-budgeted amount.

get_transactionsA

List transactions with optional filters. Returns date, payee, category, amount, notes, account, and cleared status.

get_category_balanceB

Get the balance and spending history for a specific category across one or more months.

get_budget_summaryA

Executive summary of the budget showing totals by category group, total income, total expenses, savings rate, and to-be-budgeted for a given month.

get_categoriesA

List all category groups with their categories and IDs. Useful for seeing the full budget structure.

get_payeesA

List all payees in the budget. Useful for seeing available payees and their IDs.

budget_vs_actualA

Compare budgeted amounts versus actual spending for each category in a given month. Highlights over-budget and under-budget categories.

spending_projectionA

Project end-of-month spending for each category based on the current daily spending rate. Warns about categories likely to exceed budget.

category_trendsA

Show spending trends for a category across multiple months. Identifies increasing/decreasing patterns.

spending_by_categoryA

Break down spending by category for a date range. Shows each category's total spending and percentage of total.

monthly_summaryA

Monthly financial summary showing income, expenses, savings, and savings rate across multiple months. Great for seeing trends in your overall financial health.

balance_historyA

Track an account's balance changes over time by showing the running balance at key transaction dates.

create_transactionA

Add a new transaction to an account. Use negative amounts for expenses, positive for income.

create_split_transactionA

Add a split transaction: one bank-facing total spread across multiple categories. The split amounts must sum to the total.

reconcile_currency_residualA

Book an adjustment transaction to bring a multi-currency account to the balance the bank reports, clearing accumulated FX-rate residual.

update_budget_amountA

Set the budgeted amount for a category in a specific month.

recategorize_transactionB

Change the category of an existing transaction.

create_transferB

Create a transfer between two accounts.

update_transactionA

Update fields of an existing transaction. Only the fields you provide will be changed.

delete_transactionA

Delete a transaction by its ID. This action cannot be undone.

run_bank_syncA

Sync bank transactions from linked accounts (GoCardless/SimpleFIN). Syncs a specific account or all linked accounts if none specified.

create_categoryA

Create a new budget category within a category group.

update_categoryA

Rename or hide/unhide a budget category.

delete_categoryA

Delete a budget category. Optionally transfer its transactions to another category.

create_category_groupB

Create a new category group for organizing budget categories.

update_category_groupA

Rename or hide/unhide a category group.

delete_category_groupA

Delete a category group. You must specify a category to transfer orphaned categories' transactions to.

create_payeeC

Create a new payee.

update_payeeB

Rename a payee.

delete_payeeB

Delete a payee.

get_rulesA

List all transaction rules showing their conditions and actions.

create_ruleA

Create a transaction rule. When a transaction matches the condition, the action is applied automatically.

delete_ruleA

Delete a transaction rule by its ID.

Prompts

Interactive templates invoked by user choice

NameDescription
monthly-reviewReview your budget for a specific month — checks spending vs budget, highlights overspending, and suggests adjustments.
spending-checkQuick check on current month spending — are you on track or overspending?
spending-patternsDeep analysis of spending patterns and trends over the last few months.

Resources

Contextual data attached and managed by the client

NameDescription
accountsList of all budget accounts with current balances
categoriesAll category groups and categories with IDs
payeesAll payees in the budget

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/henfrydls/actual-budget-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server