Actual Budget MCP server exposing API functionality
Actual Budget MCP server exposing API functionality
MCP server for integrating Actual Budget with Claude and other LLM assistants.
The Actual Budget MCP Server allows you to interact with your personal financial data from Actual Budget using natural language through LLMs. It exposes your accounts, transactions, and financial metrics through the Model Context Protocol (MCP).
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Resources — The Resources tool exposed by this serverTools — The Tools tool exposed by this serverCategories — The Categories tool exposed by this serverPayees — The Payees tool exposed by this serverRules — The Rules tool exposed by this serverPrompts — The Prompts tool exposed by this serverPrerequisites — The Prerequisites tool exposed by this serverDebugging — Since MCP servers communicate over stdio, debugging can be challenging. You can use the [MCPCompare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
claude mcp add actual --env ACTUAL_DATA_DIR=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_SERVER_URL=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value --env BEARER_TOKEN=your-value -- npx -y version| Variable | Description | Required |
|---|---|---|
| ACTUAL_DATA_DIR | Filesystem location the server is allowed to use. | Optional |
| ACTUAL_PASSWORD | Configuration value read at startup. | Optional |
| ACTUAL_SERVER_URL | Endpoint or connection string the server talks to. | Yes |
| ACTUAL_BUDGET_SYNC_ID | Configuration value read at startup. | Optional |
| ACTUAL_BUDGET_ENCRYPTION_PASSWORD | Configuration value read at startup. | Optional |
| BEARER_TOKEN | Credential the server authenticates with. | Yes |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.