actual-budget-mcp

finance MCP Server

MCP server for Actual Budget. Query and manage your personal finances through Claude

VerifiedInstall Ready
financefinance
2 views2 stars0 forksv0.6.1MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 1mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
2
Last synced
1mo ago
Install
Instructions detected

Install

1. Install the package

npx -y actual-budget-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

49
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (49)

Variable

Required

ACTUAL_SERVER_URL

Yes

ACTUAL_PASSWORD

Yes

ACTUAL_BUDGET_ID

Yes

get_payees

All payees in the budget

create_transaction

Add a new transaction

ACTUAL_ENCRYPTION_PASSWORD

No

ACTUAL_DATA_DIR

No

balance_history

Account balance over time

delete_transaction

Remove a transaction

list_accounts

All accounts with balances

budget_vs_actual

Budgeted vs spent per category

get_budget_month

Budget for a specific month

get_transactions

Transactions with filters

get_budget_summary

Executive budget overview

monthly_summary

Income vs expenses vs savings

run_bank_sync

Sync with linked banks

update_transaction

Edit an existing transaction

update_budget_amount

Change a budget amount

create_transfer

Transfer between accounts

update_category_group

Rename or hide a group

Prompt

Description

update_category

Rename or hide a category

create_category_group

Create a new group

Payees

`actual://payees`

delete_category_group

Delete a group

monthly-review

Complete budget review for any month — spending vs budget, overspending, suggestions

update_payee

Rename a payee

spending-patterns

Deep analysis of spending trends and patterns over multiple months

Feature

actual-budget-mcp

or

off-budget account |

category_trends

Spending trends over time

recategorize_transaction

Move to another category

delete_payee

Delete a payee

Accounts

`actual://accounts`

spending-check

Quick check: are you on track this month?

delete_category

Delete a category

create_rule

Create a transaction rule

Categories

`actual://categories`

get_category_balance

Category history across months

spending_projection

End-of-month spending forecast

delete_rule

Delete a rule

get_categories

All category groups and categories

spending_by_category

Spending breakdown by category

get_rules

All transaction rules

Tool

Description

create_payee

Create a new payee

create_category

Create a new category

Resource

URI