Ledger Service

The ledger-service MCP server lets Claude access and manage ledger files through a lightweight command interface. You can list accounts, check balances, and view transaction registers for any year, all via simple tool commands.

How to use

You interact with the ledger-service MCP server through your MCP client by calling its three core tools. Each tool runs on a specific year and, for some tools, an account name. Use these to manage and inspect ledger data without direct file handling.

How to install

Prerequisites you need before installing the ledger-service MCP server:

• Python 3.13 or higher

• uv package manager

• Node.js and npm for debugging

Install from PyPI using uv

uv pip install ledger-service

Additional configuration and running notes

Development and production running configurations are provided for Claude Desktop integration. Use the patterns below to wire the MCP server into Claude Desktop so you can start and manage the server from your environment.

"mcpServers": {
  "ledger-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/ledger-service",
      "run",
      "ledger-service"
    ]
  }
}

Debugging

To inspect and debug the server while it runs, use the inspector tool with the local setup.

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/ledger-service \
  run \
  ledger-service

Notes on running in production

For production deployment, Claude Desktop can connect using the optimized runtime command shown here.

"mcpServers": {
  "ledger-service": {
    "command": "uvx",
    "args": [
      "ledger-service"
    ]
  }
}

Available tools

list-accounts

Lists all accounts for a given year and returns a formatted list of available accounts.

account-balance

Returns the current balance for a specific account by year and account name.

account-register

Shows the transaction history for an account by year and account.