Actual Budget MCP Server

Read from the package source without running it. The installed server may list more.

• add-dashboard-widget

  Add a widget to a dashboard page in the Reports section

• balance-history

  Get account balance history over time

• budget-vs-actual

  Compare budgeted amounts against actual spending per category, for recent months. Returns JSON; amounts are integer cents.

• cash-flow

  Report income, expenses, and net cash flow per month or week. Returns JSON; amounts are integer cents.

• category-trends

  Show how spending in each category changes month over month, with trend direction. Returns JSON; amounts are integer cents.

• create-categorywrite action

  Create a new category

• create-category-groupwrite action

  Create a new category group

• create-custom-reportwrite action

  Create a saved custom report, selectable as a widget in the Reports section

• create-dashboard-pagewrite action

  Create a new, empty dashboard page in the Reports section

• create-payeewrite action

  Create a new payee

• create-rulewrite action

  Create a new rule

• create-transactionwrite action

  Create a new transaction. Use this to add transactions to accounts. Supports transfers between accounts by

• delete-categorywrite action

  Delete a category

• delete-category-groupwrite action

  Delete a category group

• delete-custom-reportwrite action

  Delete a saved custom report

• delete-dashboard-pagewrite action

  Delete a dashboard page along with every widget on it

• delete-payeewrite action

  Delete a payee

• delete-rulewrite action

  Delete a rule

• delete-transactionwrite action

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

• get-accounts

  Retrieve a list of all accounts with their current balance and ID.

• get-budget-month

  Retrieve budget data for a specific month, including budgeted amounts, spending, and balances per category.

• get-budget-months

  Retrieve a list of all available budget months in YYYY-MM format.

• get-custom-reports

  Retrieve every saved custom report from the budget's Reports section

• get-dashboards

  Retrieve every dashboard page and the widgets laid out on it. These are the dashboards under the Reports section of the sidebar.

• get-grouped-categories

  Retrieve a list of all category groups with their id, name, type and category list.

• get-payees

  Retrieve a list of all payees with their id, name, categoryId and transferAccountId.

• get-rules

  Retrieve a list of all rules. PS amount comes in cents: positive for deposit, negative for payment

• get-transactions

  Get transactions for an account with optional filtering

• hold-budget-for-next-month

  Reserve budget funds from the current month to be used in the following month. Value must be in integer cents.

• import-transactions

  Import a list of transactions into an account using reconciliation logic.

• monthly-summary

  Get monthly income, expenses, and savings

• net-worth

  Track assets, liabilities, and net worth across all accounts over time. Returns JSON; amounts are integer cents.

• organize-dashboard

  Reposition and resize several dashboard widgets at once, to rearrange a dashboard layout in the Reports section

• remove-dashboard-widgetwrite action

  Remove a widget from its dashboard page

• rename-dashboard-page

  Rename an existing dashboard page

• reset-budget-hold

  Clear any held budget amounts for a specified month, releasing them back to the available balance.

• run-bank-syncwrite action

  Run bank synchronization (GoCardless/SimpleFIN) to download latest transactions.

• set-budget-amount

  Set the budgeted amount for a category in a given month. Value must be in integer cents (e.g. 12030 = $120.30).

• set-budget-carryover

  Enable or disable carryover of unspent funds for a category into the next month.

• spending-by-category

  Get spending breakdown by category for a specified date range

• spending-by-payee

  Rank payees by how much money was spent with (or received from) each one. Returns JSON; amounts are integer cents.

• update-categorywrite action

  Update a category

• update-category-groupwrite action

  Update a category group

• update-custom-reportwrite action

  Update fields on a saved custom report, leaving unspecified fields unchanged

• update-dashboard-widgetwrite action

  Update a dashboard widget's configuration, position, or size

• update-payeewrite action

  Update a payee

• update-rulewrite action

  Update a rule

• update-transactionwrite action

  Update an existing transaction. Can modify date, amount, payee, category, notes, cleared status, and

• Code scan262 source files scanned; 262 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 1 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Actual Budget MCP Server: common questions

Is Actual Budget MCP Server safe?

Mostly: it is graded B (83/100). Read the Actual Budget MCP Server safety report

How do I install Actual Budget MCP Server?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Actual Budget MCP Server need an API key?

Yes. The registry entry asks for ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD.

Is Actual Budget MCP Server maintained?

The last commit was in the last day (2026-09-19). The latest release is v1.14.0.

What can I use instead of Actual Budget MCP Server?

Servers from other publishers that do the same job: Runapi MCP server, ctxlint MCP server and Ausca MCP server. Compare all Actual Budget MCP Server alternatives.