# Actual MCP Server

Actual MCP Server is a self-hosted ai app. 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... It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1612/actual-mcp-server

## Description

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.

## Health score

62/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 38 (76 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (16 GB minimum RAM, runs on ARM)
- Security check: 76 (no serious findings, 4 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/agigante80/actual-mcp-server
- GitHub: https://github.com/agigante80/actual-mcp-server
- Unraid: https://ca.unraid.net/apps/actual-mcp-server-0bghkvs0c7c8bg?q=actual-mcp-server

## 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.

## Alternatives

- 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1612/actual-mcp-server), the self-hosted and open-source app directory.
