minhyeoky/mcp-server-ledger

Overview

Connects your AI assistant to Ledger, a plain-text double-entry accounting system, so you can ask for account balances, income statements, or spending patterns instead of running Ledger CLI commands yourself. It is read-only, so it can answer questions about your books but cannot change entries. A fit for freelancers and small business owners who already keep their books in Ledger and want a faster way to check the numbers.

Best for

Best for
Freelancers and small business owners already on Ledger who want quick answers on their books

Use cases

• Ask for a current account balance or recent transactions
• Generate an income statement or balance sheet summary
• Check spending against budget for a category
• Get a quick read on the books before a client call

How to use

Install

npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claude

Tools exposed

• ledger

Tested with

Claude Desktop

Example client config

{\n  "mcpServers": {\n    "ledger": {\n      "command": "uv",\n      "args": [\n        "run",\n        "--env-file",\n        "/path/to/your/.env",\n        "--with",\n        "mcp[cli]",\n        "mcp",\n        "run",\n        "<repo_path>/main.py"\n      ]\n    }\n  }\n}

Notes

A Model Context Protocol server that provides a standardized interface for LLMs to interact with Ledger CLI double-entry accounting data. It allows AI assistants to execute queries and perform financial analysis on ledger files.

48 stars on GitHub. Last updated 2025-10-19.

Use cases

• Query account balances and transactions via natural language
• Generate income statements and balance sheet reports
• Analyze budget versus actual spending patterns

Pros

• Enables natural language interaction with existing ledger data
• Standard Protocol interface simplifies LLM integration
• Leverages mature, reliable Ledger CLI tooling

Cons

• Requires Ledger CLI installed and configured separately
• Limited to read-only queries, cannot modify ledger entries
• Small community (48 stars) and sparse documentation

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.