actual-budget-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ACTUAL_DATA_DIR | No | Cache directory (default: /tmp/actual-budget-mcp-data) | |
| ACTUAL_PASSWORD | Yes | Server password (set in Actual Budget under Settings) | |
| ACTUAL_BUDGET_ID | Yes | Budget Sync ID (found in Settings > Show advanced settings) | |
| ACTUAL_SERVER_URL | Yes | Your Actual Budget server URL (e.g., http://localhost:5006) | |
| ACTUAL_ENCRYPTION_PASSWORD | No | Only if your budget file is encrypted |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| monthly-review | Review your budget for a specific month — checks spending vs budget, highlights overspending, and suggests adjustments. |
| spending-check | Quick check on current month spending — are you on track or overspending? |
| spending-patterns | Deep analysis of spending patterns and trends over the last few months. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| accounts | List of all budget accounts with current balances |
| categories | All category groups and categories with IDs |
| payees | All 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