Advertise
MCP.so
Sign In

mcp-server-ledger: A Ledger CLI MCP Server

@minhyeoky

Repository

Basic information

Category

Developer Tools

Last updated

Transports

stdio

Author

minhyeoky

Submitted by

minhyeok lee

About mcp-server-ledger: A Ledger CLI MCP Server

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 repo

mcp-server-ledger: A Ledger CLI MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-ledger": {
      "command": "docker",
      "args": [
        "pull",
        "minhyeoky/mcp-ledger"
      ]
    }
  }
}

mcp-server-ledger: A Ledger CLI MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-server-ledger?

mcp-server-ledger is a Model Context Protocol server for interacting with Ledger CLI, a double-entry accounting system. It allows Large Language Models to query and analyze financial data through the Ledger CLI tool, enabling AI assistants to help with financial reporting, budget analysis, and accounting tasks.

How to use mcp-server-ledger?

Install Ledger CLI and have a valid ledger file. Install mcp-server-ledger via Docker (recommended), Smithery, or uv sync. Configure the server with the LEDGER_FILE environment variable or command-line arguments, then add the server configuration to your claude_desktop_config.json. Once set up, you can ask your AI assistant natural-language questions about your finances, and it will use the appropriate ledger commands.

Key features of mcp-server-ledger

  • ledger_balance – Shows account balances with filtering options.
  • ledger_register – Shows transaction register with detailed history.
  • ledger_accounts – Lists all accounts in the ledger file.
  • ledger_payees – Lists all payees from transactions.
  • ledger_commodities – Lists all commodities (currencies) used.
  • ledger_print – Prints transactions in ledger format.
  • ledger_stats – Shows statistics about the ledger file.
  • ledger_budget – Shows budget analysis.
  • ledger_raw_command – Runs a raw Ledger CLI command.

Use cases of mcp-server-ledger

  • Ask "Show me my expenses for the last month."
  • Ask "What's my current balance in all accounts?"
  • Ask "List all transactions with Amazon."
  • Ask "How much did I spend on groceries in 2023?"
  • Ask "Show me my budget performance for Q1."

Frequently asked questions

1

What are the prerequisites for mcp-server-ledger?

Ledger CLI must be installed and available in your PATH, and you need a valid Ledger file with your financial data.

2

How do I install mcp-server-ledger?

You can install it using Docker (`docker pull minhyeoky/mcp-ledger`), via Smithery (`npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claude`), or by cloning the repository and running `uv sync`.

3

How do I configure the ledger file?

Provide the path to your Ledger file through the `LEDGER_FILE` environment variable or via command-line arguments when starting the server.

4

Can I run custom Ledger CLI commands?

Yes, the `ledger_raw_command` tool accepts a list of command arguments and returns the raw output as text.

5

Is mcp-server-ledger secure?

The server includes basic validation to prevent command injection, but you should only use it with trusted clients, be careful about which file paths you expose, and review all commands before execution.

Comments

More Developer Tools MCP servers

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

1

Yocoolab

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

1

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

31
S

SecondSim

econdSim provisions real UK mobile numbers (non-VoIP) via eSIM, built for freelancers, sole traders, small businesses, and enterprise teams. Unlike VoIP apps and virtual numbers, SecondSim numbers register as genuine phy

UXKIN

Real UI references for AI coding agents: 500,000+ real screens, 15k+ website design systems with a DESIGN.md, and 30k+ UI elements, so your agent builds UI that looks real, not AI slop.

Advertise