ledger-service MCP server

What is ledger-service?

ledger-service is an MCP server that provides tools for accessing and managing ledger files through Claude. It is intended for users who want to interact with ledger data via Claude's MCP interface.

How to use ledger-service?

Install ledger-service from PyPI using uv pip install ledger-service, then configure Claude Desktop by adding a server entry to the configuration file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) with either a development or production configuration using uv or uvx respectively. The server exposes three tools: list-accounts, account-balance, and account-register.

Key features of ledger-service

• Lists all accounts in a ledger file for a given year
• Retrieves the balance of a specific account
• Shows detailed transaction register for an account
• Configurable ledger base path via LEDGER_BASE_PATH
• Installable from PyPI as a Python package
• Can be debugged with the MCP Inspector

Use cases of ledger-service

• Query account balances in a ledger file through Claude
• View all accounts available in a ledger for a specific year
• Review transaction history for a particular account

FAQ from ledger-service

What are the dependencies for ledger-service?

Python 3.13 or higher, the uv package manager, and optionally Node.js and npm for debugging with the MCP Inspector.

How do I install ledger-service?

Install it from PyPI using the command uv pip install ledger-service.

How do I configure Claude Desktop to use ledger-service?

Add a server entry to the Claude Desktop configuration file at the appropriate path for your operating system, using the development configuration (with uv --directory /path/to/ledger-service run ledger-service) or the production configuration (with uvx ledger-service).

What tools does ledger-service provide?

Three tools: list-accounts (requires year argument), account-balance (requires year and account arguments), and account-register (requires year and account arguments).

What license does ledger-service use?

It is licensed under the GNU GENERAL PUBLIC LICENSE Version 3, dated 29 June 2007.