ledger_balanceLABSCO SUMMARY
The numbers come from Ledger, not from the model reading your file.
That distinction is the whole value: a balance question is answered by running the balance command, so the arithmetic is Ledger's and the model only has to phrase the question and the answer. The raw command tool is the escape hatch and also the sharp edge — it runs Ledger against your financial data, so keep it to clients you trust and be deliberate about which file paths you expose.
What it is
An MCP server that wraps Ledger CLI, the command-line double-entry accounting tool. Each tool maps to a Ledger command, so answers come from your actual ledger file rather than from a model's reading of it.
What you get
ledger_balance— account balances with query, date range and display filtersledger_register— transaction history with filtering and sortingledger_accounts,ledger_payeesandledger_commodities— the names in your file, optionally filteredledger_print— matching transactions in ledger formatledger_stats— a statistical summary of the fileledger_budget— budget analysis over a reporting periodledger_raw_command— any Ledger CLI invocation, passed as a list of arguments
Requirements
Ledger CLI installed and on your PATH, plus a ledger file. Point the server at it with the LEDGER_FILE environment variable or a command-line argument. Run it with uv, or use the published Docker image and mount your ledger file into the container.
Setup effort
One command — docker pull minhyeoky/mcp-ledger
USE CASES
01
Answering “what did I spend on this last quarter?”
Ask in plain language and let the balance report with a date range do the arithmetic.
02
Finding every transaction with one merchant
List the payees to get the exact name, then pull the register filtered to it.
03
Checking budget performance for a period
Run the budget analysis over the period instead of building the comparison by hand.
04
Getting oriented in someone else's ledger file
List the accounts and commodities and read the file statistics before asking anything specific.
9 tools
Listed in project docs. Your client may show a different list.
ledger_registerledger_accountsledger_payeesledger_commoditiesledger_printledger_statsledger_budgetledger_raw_commandBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
docker pull minhyeoky/mcp-ledgerMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-ledger": {
"command": "docker",
"args": [
"run",
"-v",
"<YOUR_PATH_TO_LEDGER>/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
]
}
}
}
