Actual MCP Server

Model Context Protocol (MCP) server that connects AI assistants like LibreChat, LobeChat, Claude Desktop, and Cursor to a self-hosted Actual Budget instance,…

  • AI
  • Business & Finance
  • Productivity
  • Tools & Utilities
Model Context Protocol (MCP) server that connects AI assistants like LibreChat, LobeChat, Claude Desktop, and Cursor to a self-hosted Actual Budget instance, exposing 71 tools for conversational financial management over HTTP.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

62/100 Good

Maintained
100last commit 17 days ago
Popular
3876 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
2016 GB minimum RAM, runs on ARM
Security check
76no serious findings, 4 minor, CI, tests

Availability: platform listings confirmed today, links checked 40 days ago

GitHub stars
76
Open issues
5
Last commit
2026-11-04
Latest release
v0.27.1
License
MIT
Activity
steady

Checked 10 days ago - source: GitHub (agigante80/actual-mcp-server)

Resources & Compatibility

Minimum requirements: 16 GB RAM, 8 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the Actual sync server first Use `npm install --location=global @actual-app/sync-server` with Node.js (the runtime that runs the program) version 22 or newer. This gives you the Actual server the MCP app connects to; without it, there is no budget data for it to read. source
  • Configure MCP auth token Set a strong MCP auth token in the settings; a blank token disables all HTTP authentication and exposes your financial data unauthenticated on the LAN. source

Fetched 38 days ago - each note links to its source

Alternatives (12)

  • Akaunting - Akaunting is a self-hosted accounting application for managing finances, invoices, bills, and bank transactions.
  • Balansly - Your current balance is not always money you can freely spend.
  • Fingrom
  • Firefly III - "Firefly III" is a (self-hosted) manager for your personal finances.
  • GnuCash - Flexible accounting software for personal and small business use, GnuCash is freely available under the GNU GPL, supporting multiple OS and…
  • HomeBank - Free open-source accounting tool for personal finance and budgeting, featuring multi-platform support, detailed analysis tools, customizabl…
  • Kresus - Kresus is an open-source, libre self-hosted personal finance manager that automatically syncs new transactions from all your bank accounts…
  • MoneyManager Ex - MoneyManager Ex is a free, open-source, cross-platform, easy-to-use personal finance software.
  • Recurring Expense Tracker - Recurring Expense Tracker is a Material You recurring expense tracker, allowing you to keep track of your monthly spending.
  • You Need A Budget - Zero-based budgeting tool with real-time syncing, goal setting, partner collaboration, debt management, financial reports, and strong data…
  • actual - Actual is a free, open-source, local-first personal finance app for self-hosters that tracks budgets, expenses, bills, and investments with…
  • dumbbudget - A simple, secure personal budgeting app with PIN protection.

Checked 40 days ago - source: AlternativeTo

Common questions

How does actual-mcp-server connect AI assistants to Actual Budget?

It connects MCP-compatible AI assistants, such as LibreChat, LobeChat, and Claude Desktop, directly to a self-hosted Actual Budget instance.

What can I ask the server to do with my budget?

You can ask natural language questions, create transactions, and analyze spending.

What must be installed before the MCP server can read Actual budget data?

Install the Actual sync server first with npm install --location=global @actual-app/sync-server, using Node.js version 22 or newer. Without it, there is no budget data for the MCP app to read.

What settings should I configure for HTTP authentication?

Set the Actual server URL, Actual server password, and Actual server Sync ID, and use a strong MCP auth token. A blank MCP auth token disables HTTP authentication and can expose financial data unauthenticated on the LAN.

Answers sourced from github.com, github.com

Community

Collected 47 days ago - public community threads