Model Context Protocol server that exposes Ledger-CLI accounting commands (balance, register, budget, etc.) so LLM agents can query and analyse your personal finance ledger.
https://github.com/minhyeoky/mcp-server-ledgerIf you're tracking finances with Ledger CLI, you already know its power—and its complexity. Remember struggling with query syntax just to answer "How much did I spend on dining out last quarter?" This MCP server bridges that gap, letting you ask your AI assistant financial questions in plain English while keeping your data completely local.
You maintain meticulous financial records in Ledger format, but extracting insights shouldn't require memorizing command flags and date formats. Instead of typing:
ledger -f ~/finances.ledger --begin 2024-01-01 --end 2024-03-31 reg expenses:dining
Just ask: "Show me my dining expenses for Q1 2024"
Your AI assistant handles the translation to proper Ledger CLI commands and returns formatted results you can actually read.
Nine Essential Ledger Operations - Balance sheets, transaction registers, account listings, payee analysis, budget reports, and more. Plus a raw command tool for anything custom.
Natural Language Queries - "What's my current cash flow?" "List all Amazon transactions this year" "How am I tracking against my grocery budget?" The AI figures out the right Ledger commands.
Complete Privacy - Everything runs locally. Your financial data never leaves your machine, unlike cloud-based financial tools that want to sync your bank accounts.
Existing Workflow Integration - Keep using your current Ledger setup. This just adds an AI layer on top—no migration required.
Monthly Reviews: Instead of crafting complex balance reports, ask "Show me my expense breakdown for October" and get immediate categorized spending analysis.
Budget Tracking: "How much of my grocery budget have I used this month?" gives you instant budget vs. actual comparisons without remembering report syntax.
Transaction Analysis: "Find all transactions over $500 in the last 6 months" surfaces large purchases for review.
Account Reconciliation: "Show me all transactions for my checking account this week" helps with bank statement matching.
The server integrates with Claude Desktop in minutes. Point it at your existing Ledger file, and start asking financial questions immediately.
Docker deployment (recommended):
docker run -v /path/to/your/ledger:/main.ledger \
-e LEDGER_FILE=/main.ledger \
minhyeoky/mcp-ledger
Direct installation with uv or pip if you prefer local Python execution.
Your Ledger CLI skills aren't wasted—this amplifies them. You still get all the precision and control of double-entry accounting, but with AI assistance that makes data exploration feel natural instead of like writing database queries.
If you're already committed to local financial tracking but tired of fighting command-line syntax for basic insights, this belongs in your toolkit.