mcp-server-ledger: A Ledger CLI MCP Server

@minhyeoky

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

minhyeoky

提交者

minhyeok lee

关于 mcp-server-ledger: A Ledger CLI MCP Server

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 repo

mcp-server-ledger: A Ledger CLI MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-ledger": {
      "command": "docker",
      "args": [
        "pull",
        "minhyeoky/mcp-ledger"
      ]
    }
  }
}

mcp-server-ledger: A Ledger CLI MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-server-ledger?

mcp-server-ledger is a Model Context Protocol server for interacting with Ledger CLI, a double-entry accounting system. It allows Large Language Models to query and analyze financial data through the Ledger CLI tool, enabling AI assistants to help with financial reporting, budget analysis, and accounting tasks.

How to use mcp-server-ledger?

Install Ledger CLI and have a valid ledger file. Install mcp-server-ledger via Docker (recommended), Smithery, or uv sync. Configure the server with the LEDGER_FILE environment variable or command-line arguments, then add the server configuration to your claude_desktop_config.json. Once set up, you can ask your AI assistant natural-language questions about your finances, and it will use the appropriate ledger commands.

Key features of mcp-server-ledger

ledger_balance – Shows account balances with filtering options.
ledger_register – Shows transaction register with detailed history.
ledger_accounts – Lists all accounts in the ledger file.
ledger_payees – Lists all payees from transactions.
ledger_commodities – Lists all commodities (currencies) used.
ledger_print – Prints transactions in ledger format.
ledger_stats – Shows statistics about the ledger file.
ledger_budget – Shows budget analysis.
ledger_raw_command – Runs a raw Ledger CLI command.

Use cases of mcp-server-ledger

Ask "Show me my expenses for the last month."
Ask "What's my current balance in all accounts?"
Ask "List all transactions with Amazon."
Ask "How much did I spend on groceries in 2023?"
Ask "Show me my budget performance for Q1."

常见问题

What are the prerequisites for mcp-server-ledger?

Ledger CLI must be installed and available in your PATH, and you need a valid Ledger file with your financial data.

How do I install mcp-server-ledger?

You can install it using Docker (`docker pull minhyeoky/mcp-ledger`), via Smithery (`npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claude`), or by cloning the repository and running `uv sync`.

How do I configure the ledger file?

Provide the path to your Ledger file through the `LEDGER_FILE` environment variable or via command-line arguments when starting the server.

Can I run custom Ledger CLI commands?

Yes, the `ledger_raw_command` tool accepts a list of command arguments and returns the raw output as text.

Is mcp-server-ledger secure?

The server includes basic validation to prevent command injection, but you should only use it with trusted clients, be careful about which file paths you expose, and review all commands before execution.

开发工具分类下的更多 MCP 服务器

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Meticulous

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

Heard

Let your cloud agents talk to you. Grok Bot, Meta Muse, ChatGPT, Claude, Devin and others report progress to Heard, which reads it out loud on your Mac, and they pick up the replies you send back.

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U