Finance · AI Chatbot

Actual MCP

s-stefanov/actual-mcp

MCP server for integrating Actual Budget with Claude and other LLM assistants.

Install

docker run -i --rm \

Client configuration

{
  "mcpServers": {
    "actualBudget": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/path/to/your/data:/data",
        "-e",
        "ACTUAL_PASSWORD=your-password",
        "-e",
        "ACTUAL_SERVER_URL=https://your-actual-server.com",
        "-e",
        "ACTUAL_BUDGET_SYNC_ID=your-budget-id",
        "sstefanov/actual-mcp:latest",
        "--enable-write"
      ]
    }
  }
}

Environment variables

ACTUAL_DATA_DIRACTUAL_SERVER_URLACTUAL_PASSWORDACTUAL_BUDGET_SYNC_IDACTUAL_SYNC_TTL_MSACTUAL_BUDGET_ENCRYPTION_PASSWORD
Category
Finance, AI Chatbot
License
MIT
Updated
Oct 6, 2026

About Actual MCP

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

  • 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 (37)

  • get-transactions

    Retrieve and filter transactions by account, date, amount, category, or payee

  • create-transaction

    Create a new transaction in an account with optional category, payee, and notes

  • update-transaction

    Update an existing transaction with new category, payee, notes, or amount

  • get-accounts

    Retrieve a list of all accounts with their current balance and ID

  • balance-history

    View account balance changes over time

  • spending-by-category

    Generate spending breakdowns categorized by type

  • monthly-summary

    Get monthly income, expenses, and savings metrics

  • budget-vs-actual

    Compare budgeted amounts against actual spending per category

  • net-worth

    Track assets, liabilities, and net worth across all accounts over time

  • category-trends

    See how spending in each category moves month over month, with trend direction

  • spending-by-payee

    Rank payees by how much was spent with (or received from) each one

  • cash-flow

    Report income, expenses, and net cash flow per month or week

  • get-custom-reports

    Retrieve every saved custom report from the Reports section

  • create-custom-report

    Create a saved custom report

  • update-custom-report

    Update fields on a saved custom report, leaving the rest unchanged

  • delete-custom-report

    Delete a saved custom report

  • get-dashboards

    Retrieve every dashboard page and the widgets laid out on it

  • add-dashboard-widget

    Add a widget to a dashboard page

  • update-dashboard-widget

    Update a widget's configuration, position, or size

  • remove-dashboard-widget

    Remove a widget from its page

  • organize-dashboard

    Reposition and resize several widgets at once

  • create-dashboard-page

    rename-dashboard-page / delete-dashboard-page - Manage dashboard pages

  • get-grouped-categories

    Retrieve a list of all category groups with their categories

  • create-category

    Create a new category within a category group

  • update-category

    Update an existing category's name or group

  • delete-category

    Delete a category

  • create-category-group

    Create a new category group

  • update-category-group

    Update a category group's name

  • delete-category-group

    Delete a category group

  • get-payees

    Retrieve a list of all payees with their details

  • create-payee

    Create a new payee

  • update-payee

    Update an existing payee's details

  • delete-payee

    Delete a payee

  • get-rules

    Retrieve a list of all transaction rules

  • create-rule

    Create a new transaction rule with conditions and actions

  • update-rule

    Update an existing transaction rule

  • delete-rule

    Delete a transaction rule

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Stripe Agent Toolkit logo

Stripe Agent Toolkit

stripe/agent-toolkit

677

It contains a collection of SDKs to help you integrate Stripe with LLMs and agent frameworks, including.

Finance
Awesome Web3 MCP Servers logo

Awesome Web3 MCP Servers

demcp/awesome-web3-mcp-servers

405

MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.

Finance
Financial Datasets logo

Financial Datasets

financial-datasets/mcp-server

225

This is a Model Context Protocol (MCP) server that provides access to stock market data from Financial Datasets.

Finance
lyraios logo

lyraios

GalaxyLLMCI/lyraios

216

LYRAI is a Model Context Protocol (MCP) operating system for multi-AI AGENTs designed to extend the functionality of AI applications (such as Claude Desktop and Cursor) by enabling them to interact with financial networks and blockchain public chains.

Finance
EVM Blockchain logo

EVM Blockchain

mcpdotdirect/evm-mcp-server

216

A comprehensive Model Context Protocol (MCP) server that provides blockchain services across 60+ EVM-compatible networks. This server enables AI agents to interact with Ethereum, Optimism, Arbitrum, Base, Polygon, and many other EVM chains with a unified interface through 22 tools and 10 AI-guided prompts.

Finance
longport logo

longport

longportapp/openapi

206

Longport OpenAPI provides programmatic quote trading interfaces for investors with research and development capabilities and assists them to build trading or quote strategy analysis tools based on their own investment strategies. The functions fall into the following categories.

Finance