henfrydls/actual-budget-mcp

Overview

MCP server that exposes Actual Budget data to Claude, allowing query and management of personal finances through natural language. Built in TypeScript, it runs as a Model Context Protocol server so Claude can access budgeting data.

Best for

Best for
Claude users who already run Actual Budget and want a lightweight MCP bridge

Use cases

• Ask Claude for account balances and recent transactions
• Manage budgets by adding or categorizing transactions
• Connect Actual Budget to Claude for financial queries

How to use

Install

npx -y actual-budget-mcp --verify

Tools exposed

• ACTUAL_SERVER_URL
• ACTUAL_PASSWORD
• ACTUAL_SESSION_TOKEN
• ACTUAL_BUDGET_ID
• ACTUAL_ENCRYPTION_PASSWORD
• ACTUAL_DATA_DIR
• ACTUAL_READ_ONLY
• list_accounts
• get_budget_month
• get_transactions
• get_category_balance
• get_budget_summary
• get_categories
• get_payees
• get_rules
• balance_history
• budget_vs_actual
• spending_projection
• category_trends
• spending_by_category

Tested with

Claude Desktop, Claude Code, Cursor, VS Code

Notes

MCP server that exposes Actual Budget data to Claude, allowing query and management of personal finances through natural language. Built in TypeScript, it runs as a Model Context Protocol server so Claude can access budgeting data.

6 stars on GitHub. Last updated 2026-09-13. Licensed MIT.

Use cases

• Ask Claude for account balances and recent transactions
• Manage budgets by adding or categorizing transactions
• Connect Actual Budget to Claude for financial queries

Pros

• Small, focused TypeScript codebase
• Standard MCP interface works with Claude
• Direct access to Actual Budget data

Cons

• Very small user base with 6 stars
• Limited evidence of active maintenance or feature depth
• Requires self-hosting the MCP server

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.