Actual Budget
NPM · ACTUAL-BUDGET-MCP · 2 COMPONENTS · SCANNED SEP 20
Spending analysis and safe writes for Actual Budget: every delete previews and asks first.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 67 of 163 dependencies flagged as unhealthy (1 deprecated). View diagnostics → Partial
Provenance & Transparency71
- Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
- Cryptographically verified build provenance (signed, bound to henfrydls/actual-budget-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability87
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 2930 tokens (~73/item across 40 items; 37 tools + 3 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management63
- Stability observed for 19 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety96
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 6 of 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "create_transfer" implies "transfer" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Partial
- An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Actual Budget MCP server?
Actual Budget runs locally as an npm package, launched with npx -y actual-budget-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · actual-budget-mcp
claude mcp add henfrydls-actual-budget-mcp -- npx -y actual-budget-mcp
{
"mcpServers": {
"henfrydls-actual-budget-mcp": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
]
}
}
} {
"servers": {
"henfrydls-actual-budget-mcp": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
]
}
}
} codex mcp add henfrydls-actual-budget-mcp -- npx -y actual-budget-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"henfrydls-actual-budget-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"actual-budget-mcp"
],
"enabled": true
}
}
} openclaw mcp add henfrydls-actual-budget-mcp --command npx --arg -y --arg actual-budget-mcp
mcp_servers:
henfrydls-actual-budget-mcp:
command: "npx"
args: ["-y", "actual-budget-mcp"] {
"McpServers": {
"henfrydls-actual-budget-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"actual-budget-mcp"
]
}
}
} assistant mcp add henfrydls-actual-budget-mcp -t stdio -c npx -a -y actual-budget-mcp
{
"mcpServers": {
"henfrydls-actual-budget-mcp": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- Package version: 0.9.1 → 0.9.2 functional
- 16 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- Package version: 0.9.0 → 0.9.1 functional
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 13 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- Package version: 0.8.2 → 0.9.0 functional
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/actual-budget-mcp@0.9.2
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | henfrydls/actual-budget-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/henfrydls/actual-budget-mcp/.github/workflows/publish.yml@refs/tags/v0.9.2 |
| Rekor log index | 2871393907 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:c7ea37d6353e528c867664a82d13e0227fc369edce39679c1fd41a61f08926dbc5b39904e3a45ad3fc7380125d2bb4a8b96c6b9ea5b85f1e357206894 |
Background: How many MCP packages publish verified provenance →
Dependencies 163 packages
| Packages resolved | 163 |
|---|---|
| Deprecated | 1 |
| Stale | 66 |
| No linked repository | 2 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
balance_history ~82
Track an account's balance changes over time by showing the running balance at key transaction dates.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | yes | Account name or ID |
| end_date | string | – | End date (YYYY-MM-DD or natural language). Defaults to today. |
| start_date | string | – | Start date (YYYY-MM-DD or natural language). Defaults to 3 months ago. |
No output schema declared.
No examples provided.
budget_vs_actual ~65
Compare budgeted amounts versus actual spending for each category in a given month. Highlights over-budget and under-budget categories.
| Name | Type | Req | Description |
|---|---|---|---|
| group | string | – | Filter to a specific category group name |
| month | string | – | Month (YYYY-MM or natural language). Defaults to current month. |
No output schema declared.
No examples provided.
category_trends ~63
Show spending trends for a category across multiple months. Identifies increasing/decreasing patterns.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Category name or ID. If omitted, shows trends for top spending categories. |
| months | number | – | Number of months to analyze (default 6) |
No output schema declared.
No examples provided.
create_account ~107
Create a new budget account (on-budget or off-budget). Returns the new account ID so transactions can target it right away.
| Name | Type | Req | Description |
|---|---|---|---|
| initialBalance | number | – | Opening balance in human amounts (e.g. 1500.50, not cents). Creates the "Starting Balance" transaction. |
| name | string | yes | Account name |
| offBudget | boolean | – | Whether the account is off-budget (tracked but outside the budget, e.g. a loan or investment). Defaults to false. |
No output schema declared.
No examples provided.
create_category ~47
Create a new budget category within a category group.
| Name | Type | Req | Description |
|---|---|---|---|
| group | string | yes | Category group name or ID to add this category to |
| name | string | yes | Name for the new category |
No output schema declared.
No examples provided.
create_category_group ~32
Create a new category group for organizing budget categories.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Name for the new category group |
No output schema declared.
No examples provided.
create_payee ~28
Create a new payee.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Name for the new payee |
No output schema declared.
No examples provided.
create_rule ~158
Create a transaction rule. When a transaction matches the condition, the action is applied automatically.
| Name | Type | Req | Description |
|---|---|---|---|
| action_field | string | yes | Field to set: category, payee, notes |
| action_value | string | yes | Value to set (category name/ID, payee name, or note text) |
| condition_field | string | yes | Field to match: payee, category, amount, notes, imported_payee |
| condition_op | string | yes | Operator: is, contains, oneOf, isNot, doesNotContain, matches, gt, lt, gte, lte |
| condition_value | string | yes | Value to match against |
| stage | string | – | When to apply: null (default), pre, or post |
No output schema declared.
No examples provided.
create_split_transaction ~144
Add a split transaction: one bank-facing total spread across multiple categories. The split amounts must sum to the total.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | yes | Account name or ID |
| amount | number | yes | Total amount (negative for expenses, positive for income). Must equal the sum of the splits. |
| cleared | boolean | – | Whether the transaction is cleared |
| date | string | – | Transaction date (YYYY-MM-DD or "today", "yesterday"). Defaults to today. |
| notes | string | – | Notes for the parent transaction |
| payee | string | – | Payee name |
| splits | array | yes | Two or more splits whose amounts sum to the total. |
No output schema declared.
No examples provided.
create_transaction ~132
Add a new transaction to an account. Use negative amounts for expenses, positive for income.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | yes | Account name or ID |
| amount | number | yes | Amount (negative for expenses, positive for income). Use human amounts like -150.50, not cents. |
| category | string | – | Category name or ID |
| cleared | boolean | – | Whether the transaction is cleared |
| date | string | – | Transaction date (YYYY-MM-DD or "today", "yesterday"). Defaults to today. |
| notes | string | – | Transaction notes |
| payee | string | – | Payee name |
No output schema declared.
No examples provided.
create_transfer ~90
Create a transfer between two accounts.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Transfer amount (positive number, e.g., 5000.00) |
| date | string | – | Date (YYYY-MM-DD or natural language). Defaults to today. |
| from_account | string | yes | Source account name or ID |
| notes | string | – | Transfer notes |
| to_account | string | yes | Destination account name or ID |
No output schema declared.
No examples provided.
delete_account ~119
Delete an account and its entire transaction history. Destructive and irreversible: the first call only previews what would be lost, and deleting requires both confirm: true and confirm_name set to the account's exact name. Prefer closing an account when you just want to retire it.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | yes | Account name or ID to delete |
| confirm | boolean | – | Must be true to delete. Without it, the tool only previews. |
| confirm_name | string | – | The account's exact name, echoed back as a safeguard against deleting the wrong account. |
No output schema declared.
No examples provided.
delete_category ~132
Delete a budget category. Destructive and irreversible: the first call only previews, and deleting requires confirm: true plus confirm_name set to the category's exact name. Deleting a category also destroys its budget and rollover history; pass transfer_to to keep its transactions categorised.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | yes | Category name or ID to delete |
| confirm | boolean | – | Must be true to delete. Without it, the tool only previews. |
| confirm_name | string | – | The category's exact name, echoed back as a safeguard. |
| transfer_to | string | – | Category name or ID to transfer existing transactions to |
No output schema declared.
No examples provided.
delete_category_group ~130
Delete a category group and every category in it. Destructive and irreversible: the first call only previews, and deleting requires confirm: true plus confirm_name set to the group's exact name. You must specify a category to transfer orphaned categories' transactions to.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Must be true to delete. Without it, the tool only previews. |
| confirm_name | string | – | The group's exact name, echoed back as a safeguard. |
| group | string | yes | Category group name or ID to delete |
| transfer_to | string | yes | Category name or ID to transfer orphaned transactions to |
No output schema declared.
No examples provided.
delete_payee ~98
Delete a payee. Destructive and irreversible: the first call only previews, and deleting requires confirm: true plus confirm_name set to the payee's exact name.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Must be true to delete. Without it, the tool only previews. |
| confirm_name | string | – | The payee's exact name, echoed back as a safeguard. |
| payee | string | yes | Payee name or ID to delete |
No output schema declared.
No examples provided.
delete_rule ~68
Delete a transaction rule by its ID. Destructive and irreversible: the first call only previews the rule, and deleting requires confirm: true.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Must be true to delete. Without it, the tool only previews. |
| rule_id | string | yes | Rule ID to delete |
No output schema declared.
No examples provided.
delete_transaction ~69
Delete a transaction by its ID. Destructive and irreversible: the first call only previews what would be lost, and deleting requires confirm: true.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Must be true to delete. Without it, the tool only previews. |
| transaction_id | string | yes | Transaction ID to delete |
No output schema declared.
No examples provided.
get_budget_month ~79
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.
| Name | Type | Req | Description |
|---|---|---|---|
| month | string | – | Month in YYYY-MM format, or natural language like "this month", "last month", "January 2025". Defaults to current month. |
No output schema declared.
No examples provided.
get_budget_summary ~58
Executive summary of the budget showing totals by category group, total income, total expenses, savings rate, and to-be-budgeted for a given month.
| Name | Type | Req | Description |
|---|---|---|---|
| month | string | – | Month (YYYY-MM or natural language). Defaults to current month. |
No output schema declared.
No examples provided.
get_categories ~26
List all category groups with their categories and IDs. Useful for seeing the full budget structure.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_category_balance ~53
Get the balance and spending history for a specific category across one or more months.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | yes | Category name or ID |
| months | number | – | Number of months to look back (default 3) |
No output schema declared.
No examples provided.
get_payees ~27
List all payees in the budget. Useful for seeing available payees and their IDs.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_rules ~18
List all transaction rules showing their conditions and actions.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_transactions ~189
List transactions with optional filters. Returns date, payee, category, amount, notes, account, and cleared status.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | Account name or ID to filter by |
| category | string | – | Category name to filter by (partial match) |
| end_date | string | – | End date (YYYY-MM-DD or natural language). Defaults to today. |
| limit | number | – | Maximum number of transactions to return (default 50) |
| max_amount | number | – | Maximum amount in human format |
| min_amount | number | – | Minimum amount in human format (e.g., -500 for expenses of at least 500) |
| payee | string | – | Payee name to filter by (partial match) |
| start_date | string | – | Start date (YYYY-MM-DD or natural language like "start of month", "30 days ago"). Defaults to start of current month. |
No output schema declared.
No examples provided.
list_accounts ~27
List all budget accounts with their current balances, type (on-budget/off-budget), and status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monthly_summary ~51
Monthly financial summary showing income, expenses, savings, and savings rate across multiple months. Great for seeing trends in your overall financial health.
| Name | Type | Req | Description |
|---|---|---|---|
| months | number | – | Number of months to show (default 3) |
No output schema declared.
No examples provided.
recategorize_transaction ~40
Change the category of an existing transaction.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | yes | New category name or ID |
| transaction_id | string | yes | Transaction ID |
No output schema declared.
No examples provided.
reconcile_currency_residual ~141
Book an adjustment transaction to bring a multi-currency account to the balance the bank reports, clearing accumulated FX-rate residual.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | yes | Account name or ID to reconcile |
| category | string | yes | Category to book the adjustment under (name or ID) |
| date | string | – | Date for the adjustment (YYYY-MM-DD or "today"). Defaults to today. |
| notes | string | – | Note for the adjustment. Defaults to "FX residual adjustment". |
| payee | string | – | Optional payee for the adjustment |
| target_balance | number | – | Balance the bank reports for this account (human amount). Defaults to 0. |
No output schema declared.
No examples provided.
repair_sync ~48
Repair the budget's sync state when operations fail with an out-of-sync error. Rebuilds sync bookkeeping without modifying budget data. Use this when other tools report that the budget is out of sync.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
run_bank_sync ~58
Sync bank transactions from linked accounts (GoCardless/SimpleFIN). Syncs a specific account or all linked accounts if none specified.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | Account name or ID to sync. If omitted, syncs all linked accounts. |
No output schema declared.
No examples provided.
spending_by_category ~107
Break down spending by category for a date range. Shows each category's total spending and percentage of total.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | End date (YYYY-MM-DD or natural language). Defaults to today. |
| include_income | boolean | – | Include income categories (default: false) |
| limit | number | – | Maximum number of categories to show (default 20) |
| start_date | string | – | Start date (YYYY-MM-DD or natural language). Defaults to start of current month. |
No output schema declared.
No examples provided.
spending_projection ~54
Project end-of-month spending for each category based on the current daily spending rate. Warns about categories likely to exceed budget.
| Name | Type | Req | Description |
|---|---|---|---|
| month | string | – | Month to project (YYYY-MM or natural language). Defaults to current month. |
No output schema declared.
No examples provided.
update_budget_amount ~75
Set the budgeted amount for a category in a specific month.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | New budgeted amount (human-readable, e.g., 5000.00) |
| category | string | yes | Category name or ID |
| month | string | – | Month (YYYY-MM or natural language). Defaults to current month. |
No output schema declared.
No examples provided.
update_category ~57
Rename or hide/unhide a budget category.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | yes | Category name or ID |
| hidden | boolean | – | Set to true to hide, false to unhide |
| name | string | – | New name for the category |
No output schema declared.
No examples provided.
update_category_group ~59
Rename or hide/unhide a category group.
| Name | Type | Req | Description |
|---|---|---|---|
| group | string | yes | Category group name or ID |
| hidden | boolean | – | Set to true to hide, false to unhide |
| name | string | – | New name for the group |
No output schema declared.
No examples provided.
update_payee ~40
Rename a payee.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | New name for the payee |
| payee | string | yes | Payee name or ID |
No output schema declared.
No examples provided.
update_transaction ~122
Update fields of an existing transaction. Only the fields you provide will be changed.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | – | New amount (negative for expenses, positive for income). Human amounts, not cents. |
| category | string | – | New category name or ID |
| cleared | boolean | – | Whether the transaction is cleared |
| date | string | – | New date (YYYY-MM-DD or "today", "yesterday") |
| notes | string | – | New notes |
| payee | string | – | New payee name |
| transaction_id | string | yes | Transaction ID |
No output schema declared.
No examples provided.
What is the Actual Budget MCP server?
Actual Budget is an MCP server listed in the public MCP registry as io.github.henfrydls/actual-budget-mcp. Spending analysis and safe writes for Actual Budget: every delete previews and asks first. This page covers its npm package (actual-budget-mcp).
Is the Actual Budget MCP server safe to use?
Actual Budget scores 86 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Actual Budget MCP server expose?
Actual Budget exposes 37 tools: list_accounts, get_budget_month, get_transactions, get_category_balance, get_budget_summary, and 32 more. Their descriptions and schemas cost roughly 2,893 tokens of context every time the server is loaded.
Is the Actual Budget MCP server still maintained?
Actual Budget is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Actual Budget MCP server under?
Actual Budget declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.