Is Actual Mcp safe to use?

Actual Mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Actual Mcp?

Actual Mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Actual Mcp do?

Actual Mcp provides 22 tools: get-transactions, create-transaction, update-transaction, get-accounts, balance-history and 17 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Actual Mcp?

Actual Mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.

Is Actual Mcp actively maintained?

Actual Mcp is actively maintained — last commit was 0 days ago. It has 146 GitHub stars.

Actual Mcp

Name: Actual Mcp
Author: s-stefanov

version · by s-stefanov

Model Context Protocol for Actual Budget API

146 6.3k/wk 22 tools GitHub npm

No known CVEs

MIT license

Actively maintained

Last commit 0d ago

Works with most clients

Transport: stdio, sse

22 tools · ~948 tok

Grade B · 0.5% of 200K ctx

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "actualBudget": {
      "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"
      ],
      "command": "docker"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/actual-mcp)](https://mcppedia.org/s/actual-mcp)

Read me

What Actual Mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'version' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

88/100across 5 weighted dimensions

How we score →

0255075100

−12

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked version against OSV.dev.

Inventory

Tools (22)

Click any tool to inspect its schema.

~948 tokens total

Inventory

Resources (3)

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

Inventory

Prompts (2)

financial-insights

Generate insights and recommendations based on your financial data

budget-review

Analyze your budget compliance and suggest adjustments

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Actual Mcp safe to use?: Actual Mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Actual Mcp?: Actual Mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Actual Mcp do?: Actual Mcp provides 22 tools: get-transactions, create-transaction, update-transaction, get-accounts, balance-history and 17 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Actual Mcp?: Actual Mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is Actual Mcp actively maintained?: Actual Mcp is actively maintained — last commit was 0 days ago. It has 146 GitHub stars.

Similar servers

Others in finance

View all →

Alpha Vantage Mcp95

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

151 3

Spreedly Mcp92

A Model Context Protocol (MCP) server that provides AI assistants with direct access to the Spreedly payments API. Enables LLMs to manage gateways, process transactions, tokenize payment methods, and more, through structured, validated tool calls.

9 8

io.github.rezmeplxrf/insightsentry_mcp91

MCP server for InsightSentry financial data API - market data, options, screeners, and more

io.github.xkumakichi/xaip-mcp-server90

AI agents get on-chain identity, credentials, reputation, escrow, and persistent memory on XRPL.

MCP Security Weekly

Get CVE alerts and security updates for Actual Mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "actualBudget": {
      "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"
      ],
      "command": "docker"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/actual-mcp)](https://mcppedia.org/s/actual-mcp)

Read me

What Actual Mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'version' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

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 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

Reporting & Analytics

spending-by-category - Generate spending breakdowns categorized by type
monthly-summary - Get monthly income, expenses, and savings metrics

Payees

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

Rules

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

Prompts

financial-insights - Generate insights and recommendations based on your financial data
budget-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:

docker pull sstefanov/actual-mcp:latest

Local setup

Clone the repository:

git clone https://github.com/s-stefanov/actual-mcp.git
cd actual-mcp

Install dependencies:

npm install

Build the server:

npm run build

Build the local docker image (optional):

docker build -t <local-image-name> .

Configure environment variables (optional):

# Path to your Actual Budget data directory (default: ~/.actual)
export ACTUAL_DATA_DIR="/path/to/your/actual/data"

# If using a remote Actual server
export ACTUAL_SERVER_URL="https://your-actual-server.com"
export ACTUAL_PASSWORD="your-password"

# Specific budget to use (optional)
export ACTUAL_BUDGET_SYNC_ID="your-budget-id"

Optional: separate encryption budget password

If your Actual setup requires a different password to unlock the local/encrypted budget data than the server authentication password, you can set ACTUAL_BUDGET_ENCRYPTION_PASSWORD in addition to ACTUAL_PASSWORD.

# If server auth and encryption/unlock use different passwords
export ACTUAL_BUDGET_ENCRYPTION_PASSWORD=

... [View full README on GitHub](https://github.com/s-stefanov/actual-mcp#readme)

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

88/100across 5 weighted dimensions

How we score →

0255075100

−12

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked version against OSV.dev.

Inventory

Tools (22)

Click any tool to inspect its schema.

~948 tokens total

Inventory

Resources (3)

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

Inventory

Prompts (2)

financial-insights

Generate insights and recommendations based on your financial data

budget-review

Analyze your budget compliance and suggest adjustments

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Actual Mcp safe to use?: Actual Mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Actual Mcp?: Actual Mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Actual Mcp do?: Actual Mcp provides 22 tools: get-transactions, create-transaction, update-transaction, get-accounts, balance-history and 17 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Actual Mcp?: Actual Mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is Actual Mcp actively maintained?: Actual Mcp is actively maintained — last commit was 0 days ago. It has 146 GitHub stars.