actual-mcp-server
by agigante80
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TZ | No | Timezone for timestamps (default: UTC) | |
| DEBUG | No | Enable debug mode (default: false) | |
| VERSION | No | Server version (auto-detected) | |
| NODE_ENV | No | Node environment (default: production) | |
| LOG_LEVEL | No | Log level override: error, warn, info, debug (default: info) | |
| OIDC_ISSUER | No | OIDC issuer URL (required if AUTH_PROVIDER=oidc) | |
| OIDC_SCOPES | No | Comma-separated required scopes (optional) | |
| AUTH_PROVIDER | No | Auth mode: none or oidc (default: none) | |
| BUDGET_1_NAME | No | Name for budget 1 | |
| MCP_HTTPS_KEY | No | Path to PEM private key file | |
| MCP_HTTP_PATH | No | HTTP endpoint routing path (default: /http) | |
| OIDC_RESOURCE | No | Expected aud claim in JWT (optional) | |
| MCP_HTTPS_CERT | No | Path to PEM certificate file | |
| ACTUAL_PASSWORD | Yes | Password for Actual Budget server | |
| AUTH_BUDGET_ACL | No | Per-user budget ACL (optional) | |
| MCP_BRIDGE_PORT | No | Port for MCP server to listen on (default: 3000 dev / 3600 Docker) | |
| BUDGET_1_SYNC_ID | No | Sync ID for budget 1 | |
| MCP_ENABLE_HTTPS | No | Enable native TLS (default: false; requires cert and key) | |
| ACTUAL_SERVER_URL | Yes | URL of your Actual Budget server (e.g., http://localhost:5006) | |
| BUDGET_1_PASSWORD | No | Password for budget 1 (falls back to ACTUAL_PASSWORD) | |
| MCP_BRIDGE_LOG_DIR | No | Directory for log files (default: ./logs) | |
| MCP_BRIDGE_USE_TLS | No | Set to true to advertise https:// (default: false) | |
| MCP_TRANSPORT_MODE | No | Transport mode: --http or --stdio (default: --http) | |
| BUDGET_1_SERVER_URL | No | Server URL for budget 1 (falls back to ACTUAL_SERVER_URL) | |
| BUDGET_DEFAULT_NAME | No | Name for default budget (default: Default) | |
| MCP_BRIDGE_DATA_DIR | No | Directory to store Actual Budget local data (default: ./actual-data) | |
| USE_CONNECTION_POOL | No | Enable session-based connection pooling (default: true) | |
| MCP_BRIDGE_BIND_HOST | No | Host address to bind server to (default: 0.0.0.0) | |
| MCP_BRIDGE_HTTP_PATH | No | Advertised HTTP path shown to clients | |
| MCP_BRIDGE_LOG_LEVEL | No | Log level: error, warn, info, debug (default: debug) | |
| MCP_BRIDGE_MAX_FILES | No | Keep rotated logs for N days (e.g., 14d) (default: 14d) | |
| ACTUAL_BUDGET_SYNC_ID | Yes | Budget Sync ID from Actual Settings | |
| MCP_BRIDGE_STORE_LOGS | No | Enable file logging (default: false) | |
| MCP_SSE_AUTHORIZATION | No | Static Bearer token (recommended for production when AUTH_PROVIDER=none) | |
| ACTUAL_API_CONCURRENCY | No | Max concurrent Actual API operations (default: 5) | |
| ACTUAL_BUDGET_PASSWORD | No | Optional encryption password for encrypted budgets | |
| MCP_BRIDGE_PUBLIC_HOST | No | Public hostname/IP for server (auto-detected) | |
| MAX_CONCURRENT_SESSIONS | No | Maximum concurrent MCP sessions (default: 15) | |
| MCP_BRIDGE_MAX_LOG_SIZE | No | Rotate when file reaches size (e.g., 20m) (default: 20m) | |
| MCP_BRIDGE_PUBLIC_SCHEME | No | Public scheme (http or https) (auto-detected) | |
| MCP_BRIDGE_DEBUG_TRANSPORT | No | Enable transport-level debug logging (default: false) | |
| BUDGET_1_ENCRYPTION_PASSWORD | No | Encryption password for budget 1 | |
| SESSION_IDLE_TIMEOUT_MINUTES | No | Minutes before idle session cleanup (default: 5 pool / 2 HTTP) | |
| MCP_BRIDGE_ROTATE_DATEPATTERN | No | Date pattern for rotated log filenames (default: YYYY-MM-DD) |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/agigante80/actual-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server