Skip to content
Actual Budget logo

Actual Budget MCP server

Open-source personal finance app with envelope budgeting (self-hosted)

Actual Budget is not a separate install. One Activepieces MCP server exposes it alongside 770+ other apps, behind a single URL.

Tools
11
Works with
Any MCP client
Auth
Custom auth
License
MIT, open source
Updated
November 2026

About the Actual Budget MCP server

Connect Actual Budget once in Activepieces and every action it ships becomes a tool your assistant can call, behind the same server URL as the rest of your apps. Your agent reaches Actual Budget and 770+ other apps over a single connection, on our cloud or a self-hosted install.

Tools

Actual Budget tools your AI can run

Once connected, your assistant can call any of these Actual Budget actions by asking in plain language.

  • Get Budget

    Gets the budget for one month: totals plus budgeted, spent and balance per category (amounts in cents).

    2 fields

  • Import Transaction

    Adds one transaction to an account. Actual runs your rules on it and skips it when the Imported ID was already imported.

    10 fields

  • Import Transactions

    Imports many transactions into one account. Amounts are integer cents (-1250 = -12.50). Rows whose imported_id was already imported are skipped.

    2 fields

  • Get Categories

    Gets every budget category as a flat list.

  • Get Accounts

    Gets every account in the budget (open and closed).

  • Find Payees

    Finds payees whose name contains the search text (all payees when empty).

    1 field

  • Find Transactions

    Finds transactions in a date range, optionally filtered by account, payee, category, amount or text.

    9 fields

  • Update Transaction

    Changes fields of an existing transaction. Empty fields are left unchanged.

    8 fields

  • Delete Transaction

    Deletes a transaction (and its splits). This cannot be undone from the flow.

    1 field

  • Set Budget Amount

    Sets how much is budgeted for a category in a month (replaces the current amount).

    3 fields

  • Run Bank Sync

    Pulls new transactions from the bank for one linked account, or for all linked accounts.

    1 field

Triggers

Actual Budget events your agent can watch

These start a run the moment something happens in Actual Budget, so work gets picked up on its own.

  • New Transaction

    Triggers when a transaction dated within the last 7 days (or later) is added to an account. Split transactions trigger once, with their splits.

    1 field

Give your assistant Actual Budget

Connect Actual Budget once and every tool above is callable from Claude, Cursor or any MCP client, behind the same server URL as 770+ other apps. Free to start.

Actual Budget MCP, answered.

No. That is the point of it. One Activepieces server exposes Actual Budget alongside every other piece you connect, so your client keeps a single connection.

Yes. Activepieces is open source and free to start, and the MCP server is included on every plan, from the free cloud tier to any self-hosted deployment.

Connect Actual Budget in Activepieces, enable the server under Settings → MCP Server, then paste your server URL into your client config. It authenticates over OAuth on first use.

It can call 11 tools, including Get Budget, Import Transaction, Import Transactions, and chain them with steps in other apps inside the same run.

Connections use OAuth2 with limited scopes and are stored under 256-bit encryption, with no API to read them back, so an agent gets scoped access rather than your keys.