Queries and analyzes double-entry accounting data with Ledger CLI for financial reports and budget analysis.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add ledger --env LEDGER_FILE='<LEDGER_FILE>' -- docker run -v /path/to/your/ledger/file.ledger:/main.ledger -e LEDGER_FILE=/main.ledger -i --rm minhyeoky/mcp-ledger~/.codex/config.toml
[mcp_servers.ledger]
command = "docker"
args = ["run", "-v", "/path/to/your/ledger/file.ledger:/main.ledger", "-e", "LEDGER_FILE=/main.ledger", "-i", "--rm", "minhyeoky/mcp-ledger"]
env = { LEDGER_FILE = "<LEDGER_FILE>" }
# codex mcp add ledger --env LEDGER_FILE='<LEDGER_FILE>' -- docker run -v /path/to/your/ledger/file.ledger:/main.ledger -e LEDGER_FILE=/main.ledger -i --rm minhyeoky/mcp-ledger~/.cursor/mcp.json
{
"mcpServers": {
"ledger": {
"command": "docker",
"args": [
"run",
"-v",
"/path/to/your/ledger/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
],
"env": {
"LEDGER_FILE": "<LEDGER_FILE>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ledger": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-v",
"/path/to/your/ledger/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
],
"env": {
"LEDGER_FILE": "<LEDGER_FILE>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ledger": {
"command": "docker",
"args": [
"run",
"-v",
"/path/to/your/ledger/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
],
"env": {
"LEDGER_FILE": "<LEDGER_FILE>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"ledger": {
"command": "docker",
"args": [
"run",
"-v",
"/path/to/your/ledger/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
],
"env": {
"LEDGER_FILE": "<LEDGER_FILE>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"ledger": {
"command": "docker",
"args": [
"run",
"-v",
"/path/to/your/ledger/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
],
"env": {
"LEDGER_FILE": "<LEDGER_FILE>"
}
}
}
}Environment variables
LEDGER_FILE
Replace the placeholders with your own credentials and keep them out of version control.