Back to Home
agigante80 icon

actual-mcp-server

Verified Safe

by agigante80

Overview

A production-ready Model Context Protocol (MCP) server that bridges AI assistants with Actual Budget, enabling natural language financial management through 51 specialized tools for personal finance.

Installation

Run Command
docker run -d --name actual-mcp-server -p 3600:3600 -e ACTUAL_SERVER_URL=http://your-actual-server:5006 -e ACTUAL_PASSWORD=your_password -e ACTUAL_BUDGET_SYNC_ID=your_sync_id -e MCP_SSE_AUTHORIZATION=$(openssl rand -hex 32) -v actual-mcp-data:/data agigante80/actual-mcp-server:latest

Environment Variables

  • ACTUAL_SERVER_URL
  • ACTUAL_PASSWORD
  • ACTUAL_BUDGET_SYNC_ID
  • MCP_SSE_AUTHORIZATION
  • MCP_ENABLE_HTTPS
  • MCP_HTTPS_CERT
  • MCP_HTTPS_KEY
  • ACTUAL_BUDGET_PASSWORD
  • MCP_BRIDGE_DATA_DIR
  • MCP_BRIDGE_PORT
  • MCP_TRANSPORT_MODE
  • MAX_CONCURRENT_SESSIONS
  • SESSION_IDLE_TIMEOUT_MINUTES
  • DEBUG
  • LOG_LEVEL

Security Notes

Authentication to the MCP server via Bearer token is highly recommended by setting `MCP_SSE_AUTHORIZATION`. If this variable is not set, the server runs unauthenticated. `execSync` is used for internal versioning information, which is generally safe. Sensitive credentials for Actual Budget are pulled from environment variables. No other malicious patterns, `eval`, or obfuscation found.

Similar Servers

Stats

Interest Score33
Security Score8
Cost ClassLow
Avg Tokens100
Stars3
Forks0
Last Update2026-01-13

Tags

financial managementpersonal financeAI assistantActual BudgetMCP serverLibreChatLobeChat