actual-budget-mcp

MCPattested
v0.9.2io.github.henfrydlsUnknownUpdated todaynpmGitHub

Spending analysis and safe writes for Actual Budget: every delete previews and asks first.

Works in
ClaudeCursorCopilotGemini

Inferred from the transports this listing declares (stdio). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.

Attested build
A verified provenance attestation binds this artifact to the listed repository. Nobody has claimed the listing yet — this proves where the code was built, not who stands behind it.
6GitHub stars
todayLast update
Reads these credentials
  • ACTUAL_PASSWORDAPI keyoptional

    Password for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN

  • ACTUAL_SESSION_TOKENAPI keyoptional

    Session token for servers behind OIDC, which have no password. Use instead of ACTUAL_PASSWORD; if both are set, the token wins

  • ACTUAL_ENCRYPTION_PASSWORDAPI keyoptional

    Only needed if your budget file is end-to-end encrypted

Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Package
Authorio.github.henfrydls
LicenseUnknown
Version0.9.2
Sourcenpm+mcp-registry
Trust Status
A
85/100Trusted
Listed in Forge index+10/10
Identity verified · attested build+20/20
Ed25519 publish signature+0/5
Included automatically when the publisher runs `forge publish`
Domain verification+0/5
Publisher: host /.well-known/forge.json on the package homepage with { "publisher": "<github-login>" }
npm Trusted Publishing (Sigstore)+5/5
npm maintainer match+0/5
Publisher: add the verified GitHub login to the npm package's maintainers (npm owner add <login>)
CVE scan · clean+30/30
Static analysis · clean+20/20
Paste into Claude Code, Cursor, or any AI assistant to fix all gaps
StatusIdentity verified
PublisherUnverified
SignatureUnsigned
Domain
Provenance✓ Sigstore-verified · 97f6710
Dependencies✓ 60 resolved+ · none vulnerable
Tool surface37 tools · 6 privileged
Security scan✓ Cleanv0.9.2 · todayHow well does this scan work?
EvalsNone
IndexedSep 1, 2026

Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.

Tools

37 tools · 6 privileged
Statically extracted from the published packagev0.9.2 · 5h ago

Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

create_accountCreate a new budget account (on-budget or off-budget). Returns the new account ID

Create a new budget account (on-budget or off-budget). Returns the new account ID

No input schema was published for this tool.

create_category_groupCreate a new category group for organizing budget categories.

Create a new category group for organizing budget categories.

No input schema was published for this tool.

create_categoryCreate a new budget category within a category group.

Create a new budget category within a category group.

No input schema was published for this tool.

create_payeeCreate a new payee.

Create a new payee.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

create_transferCreate a transfer between two accounts.

Create a transfer between two accounts.

No input schema was published for this tool.

delete_accountprivilegedDelete an account and its entire transaction history. Destructive and irreversible:

Delete an account and its entire transaction history. Destructive and irreversible:

No input schema was published for this tool.

delete_category_groupprivilegedDelete a category group and every category in it. Destructive and irreversible: the

Delete a category group and every category in it. Destructive and irreversible: the

No input schema was published for this tool.

delete_categoryprivilegedDelete a budget category. Destructive and irreversible: the first call only previews,

Delete a budget category. Destructive and irreversible: the first call only previews,

No input schema was published for this tool.

delete_payeeprivilegedDelete a payee. Destructive and irreversible: the first call only previews, and

Delete a payee. Destructive and irreversible: the first call only previews, and

No input schema was published for this tool.

delete_ruleprivilegedDelete a transaction rule by its ID. Destructive and irreversible: the first call

Delete a transaction rule by its ID. Destructive and irreversible: the first call

No input schema was published for this tool.

delete_transactionprivilegedDelete a transaction by its ID. Destructive and irreversible: the first call only

Delete a transaction by its ID. Destructive and irreversible: the first call only

No input schema was published for this tool.

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_rulesList all transaction rules showing their conditions and actions.

List all transaction rules showing their conditions and actions.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

recategorize_transactionChange the category of an existing transaction.

Change the category of an existing transaction.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

repair_syncRepair the budget's sync state when operations fail with an out-of-sync error.

Repair the budget's sync state when operations fail with an out-of-sync error.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

update_category_groupRename or hide/unhide a category group.

Rename or hide/unhide a category group.

No input schema was published for this tool.

update_categoryRename or hide/unhide a budget category.

Rename or hide/unhide a budget category.

No input schema was published for this tool.

update_payeeRename a payee.

Rename a payee.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

37 of 37 tools published a description.

Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.

About

Spending analysis and safe writes for Actual Budget: every delete previews and asks first.

Keywords
mcp
Alternatives
Comparing tool surfaces…

Dependency tree

What one Forge scan resolved from npm metadata on 2026-09-17 — observed resolution, not a publisher declaration.

60 packages resolved · 4 direct · none carrying advisories Resolution stops at depth 4 and 60 packages.

The crawl stopped at the 60-package limit. The rest of the tree was never resolved.

36 more resolved packages are not drawn here (display cap: 24). Every dependency carrying an advisory is drawn regardless of the cap. Full inventory (CycloneDX SBOM)

Declared but not resolved

73 declared dependencies never landed in the tree. They are missing from Forge's resolution, not from the package.

+61 more not listed. The counts by reason above cover all of them.

Not followed: peerDependencies, optionalDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.