
A Model Context Protocol server for interacting with Ledger CLI, a powerful double-entry accounting
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 reporting, budget analysis, and accounting tasks.
·
A Model Context Protocol server for interacting with Ledger CLI, a powerful, double-entry accounting system accessible from the command line. This server allows Large Language Models to query and analyze your financial data through the Ledger CLI tool.
This MCP server exposes Ledger CLI's functionality through a standardized interface, making it easy for AI assistants to help you with financial reporting, budget analysis, and accounting tasks.
The server provides the following tools that map to Ledger CLI commands:
ledger_balance
ledger_register
ledger_accounts
ledger_payees
ledger_commodities
ledger_print
ledger_stats
ledger_budget
ledger_raw_command
You can also use the Docker image from the minhyeoky/mcp-ledger repository:
docker pull minhyeoky/mcp-ledgerAdd this to your claude_desktop_config.json:
"mcp-ledger": {
"command": "docker",
"args": [
"run",
"-v",
"/path/to/your/ledger/file.ledger:/main.ledger",
"-e",
"LEDGER_FILE=/main.ledger",
"-i",
"--rm",
"minhyeoky/mcp-ledger"
]
}Replace /path/to/your/ledger/file.ledger with the actual path to your ledger file.
To install Ledger CLI MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claudeThe easiest way to install and run this server is with uv:
uv syncThe server requires a path to your Ledger file. This can be provided through:
LEDGER_FILE environment variableAdd this to your claude_desktop_config.json:
"mcpServers": {
"ledger": {
"command": "uv",
"args": [
"run",
"--env-file",
"/path/to/your/.env", // Optional: to set LEDGER_FILE
"--with",
"mcp[cli]",
"mcp",
"run",
"<repo_path>/main.py" // Path to the main.py file in this repository
]
}
}Once configured, you can ask your AI assistant questions about your financial data:
The AI will use the appropriate Ledger CLI commands through the server to get the information.
For more detailed local testing:
mcp dev main.pyThis server is built using the Model Context Protocol Python SDK. For more information about MCP and how to develop MCP servers, see the official documentation.
To contribute to this project:
This server runs Ledger CLI commands on your financial data. While it includes basic validation to prevent command injection, you should:
This MCP server is licensed under the MIT License. Feel free to use, modify, and distribute it according to the license terms.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add ledger -- uv run --env-file /path/to/your/.env --with mcp[cli] mcp run <repo_path>/main.py{
"mcpServers": {
"ledger": {
"args": [
"run",
"--env-file",
"/path/to/your/.env",
"--with",
"mcp[cli]",
"mcp",
"run",
"<repo_path>/main.py"
],
"command": "uv"
}
}
}code --add-mcp '{"name":"ledger","args":["run","--env-file","/path/to/your/.env","--with","mcp[cli]","mcp","run","<repo_path>/main.py"],"command":"uv"}'[mcp_servers.ledger]
command = "uv"
args = ["run", "--env-file", "/path/to/your/.env", "--with", "mcp[cli]", "mcp", "run", "<repo_path>/main.py"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-server-ledger to learn what the "Mcp Server Ledger" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claudeThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-server-ledger)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-server-ledger" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.