Skip to main content
Glama
slushpupie

actual-mcp

by slushpupie
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

actual-mcp

An MCP (Model Context Protocol) server that bridges AI/LLM applications to Actual Budget. Exposes your budget data as MCP tools for use with any MCP-compatible client.

Tools

Tool

Description

list_accounts

List all accounts (name, type, balance, off-budget/closed flags)

get_transactions

Get recent transactions for an account (sorted newest-first)

add_transaction

Create a new transaction and commit it to the server

get_budget_balances

List budget categories with group and income flag

Related MCP server: YNAB MCP Server

Setup

Prerequisites

  • Python 3.12+

  • An Actual Budget server (self-hosted)

  • uv (recommended) or pip

Installation

# Clone the repo
git clone https://github.com/slushpupie/actual-mcp
cd actual-mcp

# Install dependencies
uv sync

# Configure your Actual server credentials
cp .env.example .env
# Edit .env with your server URL, password, and budget ID

Configuration

Set these environment variables (or add them to a .env file):

Variable

Required

Description

ACTUAL_SERVER_URL

Yes

URL of your Actual Budget server (e.g. http://localhost:5006)

ACTUAL_PASSWORD

Yes

Your Actual server password

ACTUAL_BUDGET_ID

Yes

The budget ID or unique budget name to operate on

Usage

Direct

uv run python mcp_server.py

This starts an MCP server over stdio, ready to connect to an MCP client.

Docker

make build
make run

Or manually:

docker run -i --rm \
  -e ACTUAL_SERVER_URL=http://host.docker.internal:5006 \
  -e ACTUAL_PASSWORD=your_password \
  -e ACTUAL_BUDGET_ID=your_budget_id \
  actual-mcp

Development

# Run tests
uv run python test_mcp_mock.py

# Run with uv
uv run python mcp_server.py
Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Actual Budget MCP Server

    yhc0712
    A
    license
    -
    quality
    C
    maintenance
    Enables AI assistants to interact with Actual Budget for personal finance management through natural language, supporting transactions, account balances, budget tracking, spending analysis, and payment searches.
    30
    MIT

  • YNAB MCP Server

    rgarcia
    A
    license
    B
    quality
    C
    maintenance
    Exposes YNAB API endpoints as MCP tools, allowing AI assistants to manage budgets, accounts, transactions, and more through natural language.
    44
    90
    MIT

  • actual-mcp-server

    agigante80
    A
    license
    -
    quality
    A
    maintenance
    MCP server that connects AI assistants to Actual Budget for budget management, enabling natural language queries, transaction creation, and spending analysis.
    1,497
    40
    MIT

  • Actual Budget MCP Server

    marcoaperez
    A
    license
    A
    quality
    A
    maintenance
    Enables LLMs to interact with a self-hosted Actual Budget instance, providing financial data and management tools with correct financial semantics and no cents math.
    11
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • Ledgy

    Log, query, and edit expenses, budgets, and accounts in Ledgy from any MCP-compatible AI assistant.

  • BankSync

    Connect AI agents to bank accounts, transactions, balances, and investments.

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/slushpupie/actual-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server