Most Actual Budget MCP implementations are simple stdio bridges designed for single-user, local use with Claude Desktop. This project goes further:
actual-mcp-server is an MCP project maintained in the agigante80/actual-mcp-server repository. The maintainer describes its purpose as “Most Actual Budget MCP implementations are simple stdio bridges designed for single-user, local use with Claude Desktop. This project goes further”. Read the project documentation for the complete scope.
The documented npm package is actual-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares ACTUAL_SERVER_URL, ACTUAL_PASSWORD, ACTUAL_BUDGET_SYNC_ID, MCP_BRIDGE_DATA_DIR. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| actual_accounts_list | List all accounts |
| actual_accounts_create | Create new account |
| actual_accounts_update | Update account details. An id that does not exist is refused rather than creating a partial record |
| actual_accounts_delete | Permanently delete account |
| actual_accounts_close | Close account. An account with NO transactions is REMOVED by Actual, not closed |
| actual_accounts_reopen | Reopen closed account. An id that is not an account is refused rather than creating one |
| actual_accounts_get_balance | Get account balance at a date |
| actual_account_flow_summary | Explain the exact balance change across a set of accounts over a date range: external income, expense outflow, credits, uncategorized inflows, and transfers… |
| actual_account_groups_list | List the custom account groups used to organise accounts in the sidebar (Actual 26.9.0+) |
| actual_account_groups_create | Create an account group. Assigning accounts to it is a separate actual_accounts_update call |
| actual_account_groups_update | Rename an account group or change its sidebar position. A group that does not exist is refused, writing nothing |
| actual_account_groups_delete | Delete an account group. Its accounts are NOT deleted, they become ungrouped |
| actual_transactions_get | Get transactions for an account |
| actual_transactions_filter | Filter with advanced criteria |
| actual_transactions_create | Create new transaction(s), including splits (pass a subtransactions array) |
| actual_transactions_import | Import and reconcile transactions |
| actual_transactions_update | Update a transaction, split a plain one in place, or edit the children of an existing split via subtransactions |
| actual_transactions_delete | Delete a transaction |
| actual_transactions_uncategorized | Summary of uncategorized transactions (totalCount, totalAmount, per-account breakdown); pass includeTransactions:true for paginated rows |
| actual_transactions_update_batch | Apply many transaction updates in ONE call (updates: [{ id, fields }]); returns per-item success and failure counts |
| actual_transactions_aggregate | Deterministic integer-cent totals grouped by month, category, category group, payee, or account; transfers excluded via transfer_id and split children… |
| actual_transactions_search_by_month | Search by month using $month transform |
| actual_transactions_search_by_amount | Find by amount range |
| actual_transactions_search_by_category | Search by category name |
| 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_recurring_expenses_summary | Detect recurring charges (subscriptions, bills) from posted history: cadence (with date-drift and month-end tolerance), latest amount, price changes… |
| actual_transfers_create | Create a paired transfer between two accounts (debit + credit linked by transfer_id, identical to UI "Make Transfer") |
| actual_tags_list | List all tags (id, tag word, optional color and description) |
| actual_tags_create | Create or upsert a tag by name; returns the tag UUID |
| actual_tags_update | Update tag name, color, or description by UUID |
| actual_tags_delete | Soft-delete a tag by UUID |
| 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_budgets_list_available | List all configured budget files |
| actual_budgets_switch | Switch active budget (multi-budget) |
| actual_budgets_get_all | List available budget files |
| actual_budgets_getMonths | List budget months |
| actual_budgets_getMonth | Get budget for a specific month |
| actual_budgets_setAmount | Set category budget amount. The month must be one the budget has (see actual_budgets_getMonths) |
| actual_budgets_transfer | Transfer amount between categories |
| actual_budgets_setCarryover | Enable/disable carryover |
| actual_budgets_holdForNextMonth | Hold funds for next month. Actual clamps the hold to what is left to budget, so the response reports the amount actually held |
| actual_budgets_resetHold | Reset hold status |
| actual_budgets_export | Export the active budget as a .zip into ACTUAL_EXPORT_DIR; returns path, byte size and sha256, never the file contents |
| actual_budgets_import | Restore a budget from an Actual .zip or a YNAB4/YNAB5 export. Destructive: the budget id comes from the archive, so re-importing an export replaces that… |
| actual_rules_create_or_update | Idempotent upsert: create a rule, or update the existing one that matches the same conditions, in a single call. Use this instead of get-then-create when… |
| actual_schedules_get | List scheduled transactions, with their next occurrence date |
| actual_schedules_create | Create a schedule (one-off or recurring); recurrence is a typed config, see src/lib/schemas/recur.ts |
| actual_schedules_update | Update an existing schedule's amount, payee, account, or recurrence |
| actual_schedules_delete | Delete a schedule |
| actual_query_run | Execute custom ActualQL query |
| actual_bank_sync | Trigger bank sync (GoCardless/SimpleFIN) |
| actual_server_info | Server status, version, build info |
| actual_server_get_version | Actual Budget server version |
| actual_get_context | Retrieve open accounts, category groups with nested categories, and payees (name-sorted, capped by payeeLimit) in a single call |
| actual_get_id_by_name | Resolve an exact name → UUID for accounts, categories, payees |
| actual_entities_search | Find accounts/categories/payees by a name pattern (contains/startsWith/endsWith/exact/fuzzy). Fixes "payee not found" from a partial or mistyped name |
{
"mcpServers": {
"actual-budget": {
"command": "npx",
"args": [
"-y",
"actual-mcp-server",
"--stdio"
],
"env": {
"ACTUAL_SERVER_URL": "http://localhost:5006",
"ACTUAL_PASSWORD": "YOUR_ACTUAL_PASSWORD",
"ACTUAL_BUDGET_SYNC_ID": "your-sync-id-here",
"MCP_BRIDGE_DATA_DIR": "/absolute/path/to/data-dir"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| ACTUAL_SERVER_URL | Declared in the maintainer’s client configuration. | Yes |
| ACTUAL_PASSWORD | Declared in the maintainer’s client configuration. | Yes |
| ACTUAL_BUDGET_SYNC_ID | Declared in the maintainer’s client configuration. | Yes |
| MCP_BRIDGE_DATA_DIR | Declared in the maintainer’s client configuration. | Optional |
메모짱 메모·할 일을 AI로 검색·정리·체크해요. / Search, write and check off notes and to-dos in Memozzang.
채팅으로 후잉 가계부를 관리하세요. 거래 입력·조회, 계정·예산 관리, 손익·재무 보고서를 지원합니다.
나라장터 낙찰정보서비스 Open API를 위한 로컬 MCP 서버
나라장터 사전규격정보서비스 Open API를 위한 로컬 MCP 서버
나라장터 입찰공고정보서비스(공공데이터포털 data.go.kr) Open API를 감싼 로컬 MCP 서버
나라장터 사용자정보서비스(공공데이터포털 data.go.kr) Open API를 감싼 로컬 MCP 서버