How do I connect Actual MCP Server to Claude?

Run `claude mcp add actual-mcp-server -- npx -y actual-mcp-server --http` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Actual MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Actual MCP Server do?

Actual MCP Server documents 40 tools to the agent, including actual_accounts_close, actual_accounts_create, actual_accounts_delete. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Actual MCP Server

Unclaimed

by agigante80

Talk to your self-hosted Actual Budget from any MCP client: a remote HTTP server for LibreChat/LobeChat or a local stdio process for Claude Desktop, with 71 tools for transactions, budgets, rules, and bank sync. No Docker needed for local use.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'actual-mcp-server' -- 'npx' '-y' 'actual-mcp-server' '--http'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

actual-budgetai-assistantapi-serverbudget-managementbudget-trackingconversation-aidockerfinance-automationfinancial-managementlibrechatmcpmodel-context-protocolnodejspersonal-financetypescript

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

40 of 40 tools

Documented tools (40)

From project documentation. A server handshake does not verify each tool’s description or behavior.

actual_accounts_close

Close account (soft delete)

actual_accounts_create

Create new account

actual_accounts_delete

Permanently delete account

actual_accounts_get_balance

Get account balance at a date

actual_accounts_list

List all accounts

actual_accounts_reopen

Reopen closed account

actual_accounts_update

Update account details

actual_budgets_export

Export the active budget as a .zip into ACTUALEXPORTDIR; returns path, byte size and sha256, never the file contents

actual_budgets_get_all

List available budget files

actual_budgets_getMonth

Get budget for a specific month

actual_budgets_getMonths

List budget months

actual_budgets_holdForNextMonth

Hold funds for next month

actual_budgets_list_available

List all configured budget files

actual_budgets_resetHold

Reset hold status

actual_budgets_setAmount

Set category budget amount

actual_budgets_setCarryover

Enable/disable carryover

actual_budgets_switch

Switch active budget (multi-budget)

actual_budgets_transfer

Transfer amount between categories

actual_notes_get

Get the note for any entity (account/category/category-group/payee UUID, or budget-YYYY-MM)

actual_notes_update

Set or clear the note for any entity; validates entity exists or matches budget-YYYY-MM pattern

actual_preferences_get

Read the budget's synced display preferences (number format, date format, currency, first day of week). Display only: all amounts stay integer cents

actual_tags_create

Create or upsert a tag by name; returns the tag UUID

actual_tags_delete

Soft-delete a tag by UUID

actual_tags_list

List all tags (id, tag word, optional color and description)

actual_tags_update

Update tag name, color, or description by UUID

actual_transactions_create

Create new transaction(s), including splits (pass a subtransactions array)

actual_transactions_delete

Delete a transaction

actual_transactions_filter

Filter with advanced criteria

actual_transactions_get

Get transactions for an account

actual_transactions_import

Import and reconcile transactions

actual_transactions_search_by_amount

Find by amount range

actual_transactions_search_by_category

Search by category name

actual_transactions_search_by_month

Search by month using $month transform

actual_transactions_search_by_payee

Find by payee/vendor

actual_transactions_summary_by_category

Spending summary grouped by category

actual_transactions_summary_by_payee

Top vendors with totals and counts

actual_transactions_uncategorized

Summary of uncategorized transactions (totalCount, totalAmount, per-account breakdown); pass includeTransactions:true for paginated rows

actual_transactions_update

Update a transaction, or edit the children of an existing split via subtransactions

actual_transactions_update_batch

Apply many transaction updates in ONE call (updates: [{ id, fields }]); returns per-item success and failure counts

actual_transfers_create

Create a paired transfer between two accounts (debit + credit linked by transferid, identical to UI "Make Transfer")

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Actual MCP Server

How do I connect Actual MCP Server to Claude?: Run `claude mcp add actual-mcp-server -- npx -y actual-mcp-server --http` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Actual MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Actual MCP Server do?: Actual MCP Server documents 40 tools to the agent, including actual_accounts_close, actual_accounts_create, actual_accounts_delete. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.