ledger-service logo

ledger-service

by MCP-Mirror

MCP Server for accessing and managing ledger files through Claude. It provides tools to list accounts, get account balances, and view transaction registers.

View on GitHub

Last updated: N/A

What is ledger-service?

The ledger-service MCP server provides a way to access and manage ledger files through the Claude interface. It implements tools for listing accounts, retrieving account balances, and showing transaction registers.

How to use ledger-service?

To use the server, install it from PyPI using uv pip install ledger-service. Configure Claude Desktop by adding the server configuration to the claude_desktop_config.json file, specifying the command and arguments for running the server. The server exposes three tools: list-accounts, account-balance, and account-register, each requiring 'year' and optionally 'account' as arguments.

Key features of ledger-service

  • List accounts in a ledger

  • Get account balance

  • Show transaction register for an account

  • Integration with Claude Desktop

  • Support for development and production configurations

Use cases of ledger-service

  • Managing personal finances through Claude

  • Accessing ledger data programmatically

  • Integrating ledger data into other applications

  • Debugging ledger-related issues

  • Automating financial reporting

FAQ from ledger-service

What is the required Python version?

Python 3.13 or higher is required.

What package manager is recommended?

The uv package manager is recommended.

How do I debug the server?

Use the MCP Inspector with the command npx @modelcontextprotocol/inspector uv --directory /path/to/ledger-service run ledger-service.

Where is the Claude Desktop config file located on MacOS?

On MacOS, the config file is located at ~/Library/Application\ Support/Claude/claude_desktop_config.json.

Where is the Claude Desktop config file located on Windows?

On Windows, the config file is located at %APPDATA%/Claude/claude_desktop_config.json.