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 |
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": 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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