All apps · 0 apps

actual-mcp-server

Docker app from actual-mcp-server's Repository

Overview

Model Context Protocol (MCP) server that connects AI assistants (LibreChat, LobeChat, Claude Desktop, Cursor) to your self-hosted Actual Budget instance, exposing 71 tools for conversational financial management over HTTP. Fill in the "Actual server URL", "Actual server password", and "Actual server Sync ID" below, and SET A STRONG "MCP auth token": a blank token disables all HTTP authentication and exposes your financial data unauthenticated on the LAN. See the project README.

Install actual-mcp-server on Unraid in a few clicks.

Find actual-mcp-server in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for actual-mcp-server Review the template variables and paths Click Install

Explore Unraid OS

Related apps

Explore more like this

Explore all

Productivity Utilities apps

Links

Projectgithub.com Supportgithub.com Registrygithub.com Templateraw.githubusercontent.com

Details

Repository

ghcr.io/agigante80/actual-mcp-server:latest

Registry

https://github.com/agigante80/actual-mcp-server/pkgs/container/actual-mcp-server

Last Updated2026-06-13

First Seen2026-06-13

Runtime arguments

Web UI: http://[IP]:[PORT:3600]/health
Network: bridge
Shell: sh
Privileged: false

Template configuration

WebUI / Health PortPorttcp

MCP HTTP endpoint and the unauthenticated health/metrics endpoints (/http, /health, /metrics).

Target: 3600
Default: 3600
Value: 3600

DataPathrw

Persistent data: the local copy of your Actual Budget data (SQLite) the server downloads to run queries against.

Target: /app/data
Default: /mnt/user/appdata/actual-mcp-server/data
Value: /mnt/user/appdata/actual-mcp-server/data

LogsPathrw

Rotated application log files.

Target: /app/logs
Default: /mnt/user/appdata/actual-mcp-server/logs
Value: /mnt/user/appdata/actual-mcp-server/logs

PUIDVariable

User ID the service runs as. On Unraid use 99 (nobody) so it can write the appdata directories.

Default: 99
Value: 99

PGIDVariable

Group ID the service runs as. On Unraid use 100 (users).

Default: 100
Value: 100

TimezoneVariable

Container timezone used for log timestamps, e.g. America/New_York.

Target: TZ
Default: Europe/Madrid
Value: Europe/Madrid

MCP auth tokenVariable

REQUIRED. The raw Bearer token clients must send. Generate with `openssl rand -hex 32`. A BLANK value disables all HTTP authentication and exposes your data unauthenticated on the LAN.

Target: MCP_SSE_AUTHORIZATION

Actual server URLVariable

Your Actual Budget server URL, e.g. https://actual.example.com or http://192.168.1.50:5006.

Target: ACTUAL_SERVER_URL

Actual server passwordVariable

Your Actual Budget server password.

Target: ACTUAL_PASSWORD

Actual server Sync IDVariable

The budget Sync ID (Actual Budget: open the budget, Settings, Show advanced settings, Sync ID).

Target: ACTUAL_BUDGET_SYNC_ID

Node EnvironmentVariable

Node.js runtime environment. Leave as production unless debugging.

Target: NODE_ENV
Default: production
Value: production

Curated

Categories