Enables access to personal financial data from Actual Budget, including accounts, transactions, and financial metrics. Provides tools for retrieving filtered transactions, generating spending breakdowns by category, viewing monthly summaries, and analyzing budget performance.
Actual Budget MCP Server
MCP server for integrating Actual Budget with Claude and other LLM assistants.
Overview
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).
Features
Resources
- Account Listings - Browse all your accounts with their balances
- Account Details - View detailed information about specific accounts
- Transaction History - Access transaction data with complete details
Tools
Transaction & Account Management
get-transactions
- Retrieve and filter transactions by account, date, amount, category, or payeeget-accounts
- Retrieve a list of all accounts with their current balance and IDbalance-history
- View account balance changes over time
Reporting & Analytics
spending-by-category
- Generate spending breakdowns categorized by typemonthly-summary
- Get monthly income, expenses, and savings metrics
Categories
get-grouped-categories
- Retrieve a list of all category groups with their categoriescreate-category
- Create a new category within a category groupupdate-category
- Update an existing category's name or groupdelete-category
- Delete a categorycreate-category-group
- Create a new category groupupdate-category-group
- Update a category group's namedelete-category-group
- Delete a category group
Payees
get-payees
- Retrieve a list of all payees with their detailscreate-payee
- Create a new payeeupdate-payee
- Update an existing payee's detailsdelete-payee
- Delete a payee
Rules
get-rules
- Retrieve a list of all transaction rulescreate-rule
- Create a new transaction rule with conditions and actionsupdate-rule
- Update an existing transaction ruledelete-rule
- Delete a transaction rule
Prompts
financial-insights
- Generate insights and recommendations based on your financial databudget-review
- Analyze your budget compliance and suggest adjustments
Installation
Prerequisites
- Node.js (v16 or higher)
- Actual Budget installed and configured
- Claude Desktop or another MCP-compatible client
- Docker Desktop (optional)
Remote access
Pull the latest docker image:
Local setup
- Clone the repository:
- Install dependencies:
- Build the server:
- Build the local docker image (optional):
- Configure environment variables (optional):
Usage with Claude Desktop
To use this server with Claude Desktop, add it to your Claude configuration:
On MacOS:
On Windows:
Add the following to your configuration...
a. Using Node.js (npx version):
b. Using Docker (local or remote images):
After saving the configuration, restart Claude Desktop.
💡
ACTUAL_DATA_DIR
is optional if you're usingACTUAL_SERVER_URL
.
💡 Use
--enable-write
to enable write-access tools.
Running an SSE Server
To expose the server over a port using Docker:
⚠️ Important: When using --enable-bearer, the BEARER_TOKEN environment variable must be set.
🔒 This is highly recommended if you're exposing your server via a public URL.
Example Queries
Once connected, you can ask Claude questions like:
- "What's my current account balance?"
- "Show me my spending by category last month"
- "How much did I spend on groceries in January?"
- "What's my savings rate over the past 3 months?"
- "Analyze my budget and suggest areas to improve"
Development
For development with auto-rebuild:
Testing the connection to Actual
To verify the server can connect to your Actual Budget data:
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. You can use the MCP Inspector:
Project Structure
index.ts
- Main server implementationtypes.ts
- Type definitions for API responses and parametersprompts.ts
- Prompt templates for LLM interactionsutils.ts
- Helper functions for date formatting and more
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
MCP server for integrating Actual Budget with Claude and other LLM assistants.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.Last updated -3GPL 3.0
- -securityAlicense-qualityAI-powered MCP server that enables Claude and other LLMs to interact directly with construction documents, drawings, and specifications through advanced RAG and hybrid search capabilities.Last updated -3MIT License
- -securityFlicense-qualityAn MCP server that allows Claude to interact with local LLMs running in LM Studio, providing access to list models, generate text, and use chat completions through local models.Last updated -10
- -securityFlicense-qualityA simple MCP server that provides a calculator tool, dynamic greeting resources, and code review prompts, demonstrating how to build standardized interfaces for LLM applications.Last updated -