Actual Budget MCP Server

Beschreibung des Anbieters

MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.

Werkzeuge

cash-flow

Report income, expenses, and net cash flow per month or week. Returns JSON; amounts are integer cents. Angabe des Anbieters · Beleg 5

net-worth

Track assets, liabilities, and net worth across all accounts over time. Returns JSON; amounts are integer cents. Angabe des Anbieters · Beleg 6

get-accounts

Retrieve a list of all accounts with their current balance and ID. Angabe des Anbieters · Beleg 7

run-bank-sync

Run bank synchronization (GoCardless/SimpleFIN) to download latest transactions. Provide accountId for a specific account, use "onbudget"/"offbudget" for groups, or omit to sync all linked accounts. Angabe des Anbieters · Beleg 8

balance-history

Get account balance history over time Angabe des Anbieters · Beleg 9

category-trends

Show how spending in each category changes month over month, with trend direction. Returns JSON; amounts are integer cents. Angabe des Anbieters · Beleg 10

monthly-summary

Get monthly income, expenses, and savings Angabe des Anbieters · Beleg 11

budget-vs-actual

Compare budgeted amounts against actual spending per category, for recent months. Returns JSON; amounts are integer cents. Angabe des Anbieters · Beleg 12

get-transactions

Get transactions with optional filtering, for one account or across all accounts if accountId is omitted Angabe des Anbieters · Beleg 13

spending-by-payee

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

create-transaction

Create a new transaction. Use this to add transactions to accounts.… Angabe des Anbieters · Beleg 15

delete-transaction

Delete a transaction by its ID. This action is permanent and cannot be undone. Angabe des Anbieters · Beleg 16

update-transaction

Update an existing transaction. Can modify date, amount, payee, category, notes, cleared status, and subtransactions, including turning a subtransaction into a transfer via transfer_account_id. Angabe des Anbieters · Beleg 17

import-transactions

Import a list of transactions into an account using reconciliation logic. Deduplicates via imported_id to prevent duplicates on repeated imports.… Angabe des Anbieters · Beleg 18

spending-by-category

Get spending breakdown by category for a specified date range Angabe des Anbieters · Beleg 19

get-custom-reports

Retrieve every saved custom report from the Reports section Angabe des Anbieters · Beleg 20

create-custom-report

Create a saved custom report Angabe des Anbieters · Beleg 20

update-custom-report

Update fields on a saved custom report, leaving the rest unchanged Angabe des Anbieters · Beleg 20

delete-custom-report

Delete a saved custom report Angabe des Anbieters · Beleg 20

get-dashboards

Retrieve every dashboard page and the widgets laid out on it Angabe des Anbieters · Beleg 20

add-dashboard-widget

Add a widget to a dashboard page Angabe des Anbieters · Beleg 20

update-dashboard-widget

Update a widget's configuration, position, or size Angabe des Anbieters · Beleg 20

remove-dashboard-widget

Remove a widget from its page Angabe des Anbieters · Beleg 20

organize-dashboard

Reposition and resize several widgets at once Angabe des Anbieters · Beleg 20

get-grouped-categories

Retrieve a list of all category groups with their categories Angabe des Anbieters · Beleg 20

create-category

Create a new category within a category group Angabe des Anbieters · Beleg 20

update-category

Update an existing category's name or group Angabe des Anbieters · Beleg 20

delete-category

Delete a category Angabe des Anbieters · Beleg 20

create-category-group

Create a new category group Angabe des Anbieters · Beleg 20

update-category-group

Update a category group's name Angabe des Anbieters · Beleg 20

Voraussetzungen

• ACTUAL_SERVER_URL · Umgebungsvariable · erforderlich · Beleg 1
• ACTUAL_PASSWORD · Umgebungsvariable · erforderlich · Beleg 1
• ACTUAL_BUDGET_SYNC_ID · Umgebungsvariable · erforderlich · Beleg 1
• npx · Paketmanager · erforderlich · Beleg 1
• Node.js · Laufzeit · erforderlich · Beleg 20
• Docker · Laufzeit · optional · Beleg 20
• ACTUAL_DATA_DIR · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 1
• ACTUAL_BUDGET_ENCRYPTION_PASSWORD · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 1
• ACTUAL_SYNC_TTL_MS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 1
• BEARER_TOKEN · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 21

Installation

npx -y actual-mcp@1.14.0

Angaben zum Baustein

—: Angabe nicht belegt.

Maintainer

s-stefanov

Repository-Lizenz

MIT

Letzter Repository-Commit

2026-09-27

Commit innerhalb 90 Tagen

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

—

Bereiche

Analyse

Plattformen

—

Version

1.14.0

Release

v1.14.0

Clients

Claude Desktop, Codex

Dokumentation

Dokumentation des Anbieters

Zugriffe und Risiken

Regelbasiert abgeleitete Zugriffe

lesen, schreiben, löschen

Authentifizierung

—

Transport

stdio, streamable-http

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe. Vor dem Einsatz Konten, Dateien, Netzwerkverbindungen und Ausführungsrechte im konkreten Paket prüfen. Eine frische Änderung am Repository belegt keine Wartung jeder einzelnen Datei.

Nur die für den Arbeitsablauf nötigen Berechtigungen vergeben und Schreibaktionen mit einem Freigabeschritt absichern. Lizenz und Wartungsdatum sind keine Sicherheitsfreigabe.

Der Lizenzbeleg betrifft das Quellcode-Repository. Einzelne Unterpakete und gehostete Dienste können eigene Bedingungen haben; prüfe sie beim konkreten Installations- oder Diensteangebot.