drio
Open app

mcp-server-ledger: A Ledger CLI MCP Server

Source

A Model Context Protocol server for interacting with Ledger CLI, a powerful double-entry accounting system. This server enables Large Language Models to query and analyze financial data through a standardized interface, making it easy for AI assistants to help with financial reporting, budget analysis, and accounting tasks.

Catalog onlyCatalog onlySTDIO

Overview

The mcp-server-ledger is a Model Context Protocol server designed to interact with Ledger CLI, a powerful double-entry accounting system. It allows Large Language Models to query and analyze financial data through a standardized interface, facilitating AI-assisted financial reporting, budget analysis, and accounting tasks.

To use the mcp-server-ledger, install Ledger CLI and set up the server with your Ledger file path. You can then ask your AI assistant questions about your financial data, and it will utilize the server to execute the appropriate Ledger CLI commands.

  • Provides various tools that map to Ledger CLI commands, including balance inquiries, transaction history, account listings, and budget analysis. - Supports raw command execution for advanced users. - Easy integration with AI assistants for real-time financial queries.
  1. Querying account balances and transaction histories.
  2. Analyzing budget performance over specific periods.
  3. Generating detailed financial reports and statistics.

Add to your AI client

Use these steps to connect mcp-server-ledger: A Ledger CLI MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-ledger-minhyeoky": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-ledger-minhyeoky"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-ledger-minhyeoky": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-ledger-minhyeoky"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-ledger-minhyeoky": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-ledger-minhyeoky"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-ledger-minhyeoky": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-ledger-minhyeoky"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-ledger-minhyeoky": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-ledger-minhyeoky"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-ledger-minhyeoky": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-ledger-minhyeoky"
      ]
    }
  }
}

FAQ

**What do I need to run this server?**

You need to have Ledger CLI installed and a valid Ledger file with your financial data.

**Is there a recommended way to install it?**

Yes, using the 'uv' tool is recommended for installation and running the server.

**Can I run raw Ledger CLI commands?**

Yes, the server allows you to execute raw Ledger CLI commands for advanced operations.

Finance