Privacy Policy

actual-budget-mcp is an MCP server that connects your Actual Budget to Claude and other MCP clients. It runs on your machine. This page says what it does with your data, which is very little, and what this website does, which is a bit more.

Last updated 15 September 2026. Applies to actual-budget-mcp 0.9.0 and later, including the Claude Desktop extension.

The short version. The server talks to exactly one place: the Actual Budget server you point it at. It keeps a copy of your budget on your own disk so it does not have to download it for every question. It never stores your password or token, never sends anything to us or to anyone else, and has no telemetry of any kind.

What the server collects

Nothing. The server has no account with us, no sign-up, no identifier, and no code path that contacts any host other than your Actual Budget server. We cannot see whether you installed it, how often you use it, or what you ask.

Where your data goes

When you ask a question, your MCP client (Claude Desktop, Claude Code, Cursor or any other) calls a tool on the server. The server reads or writes your budget through the official @actual-app/api library, against the server URL you configured. The answer goes back to your MCP client. What that client then does with it is governed by its own privacy policy, not by this one.

If you use the run_bank_sync tool, it asks your Actual Budget server to run the bank sync you have already set up there. The connection to your bank goes from your Actual server, not from this one.

What is stored on your machine

The server keeps a local copy of your budget file so that questions are answered quickly. It is a cache, not your data: your budget lives on your Actual server, and deleting the cache costs one re-download. It sits in ~/.local/share/actual-budget-mcp on Linux, ~/Library/Application Support/actual-budget-mcp on macOS and %APPDATA%\actual-budget-mcp on Windows, unless you set ACTUAL_DATA_DIR. It stays there until you delete it. We never see it.

Your credentials

The server needs your Actual server URL, your Sync ID, and either your server password or a session token. It reads them from environment variables each time it starts and keeps them in memory only while it runs. It does not write them to disk and does not log them.

Where they are stored between runs depends on how you installed it. With the Claude Desktop extension, the password and token are marked sensitive and Claude Desktop keeps them in your operating system's credential store. With a manual configuration, they are in the config file you wrote, in plain text, protected by your file permissions.

Third parties

None receive your data from the server. The code is open source under the MIT licence at github.com/henfrydls/actual-budget-mcp, and you can read every network call it makes.

Two things are worth naming because they are also true. The model you are talking to, Claude or whichever your client uses, necessarily sees the budget data you ask about, under that provider's own terms; this server cannot change that, and you should read those terms as carefully as this page. And installing with npx downloads the package from npm, which is an ordinary package download and carries no budget data, but is a network connection you did not explicitly choose.

Retention

We retain nothing, because we receive nothing. The local cache is yours and lasts until you delete it.

Your rights

Privacy laws such as the GDPR give you the right to access, correct and delete the data an organisation holds about you. We hold none, so there is nothing for us to hand over or erase. Everything the server touches is already on your machine or on your own Actual server, under your control.

This website

actual-mcp.henfrydls.com uses a self-hosted instance of Umami to count page views. It sets no cookies and does not store IP addresses or anything that identifies you. It tells us how many people read a page and roughly where they came from, and nothing about you.

Changes

If the server ever starts sending data anywhere other than your Actual server, this page will say so before that version is released, and the change will be in the release notes. We do not plan to. Adding telemetry to a tool that reads your finances would undo the point of running it yourself.

Contact

Questions about privacy: open an issue at github.com/henfrydls/actual-budget-mcp/issues, or write to henfry.delossantos@gmail.com.