ledger-service MCP server logo

ledger-service MCP server

by mprokopov

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 MCP server?

This is an MCP (Model Context Protocol) server designed to interact with ledger files. It allows users to access and manage their financial data through the Claude interface.

How to use ledger-service MCP server?

The server can be installed from PyPI using uv pip install ledger-service. After installation, configure Claude Desktop by adding the server configuration to the claude_desktop_config.json file. The server provides three tools: list-accounts, account-balance, and account-register, each requiring specific arguments (year, account) to retrieve the desired information.

Key features of ledger-service MCP server

  • Lists all accounts in the ledger

  • Gets the balance for a specific account

  • Shows the transaction register for an account

  • Integration with Claude Desktop

Use cases of ledger-service MCP server

  • Managing personal finances through Claude

  • Accessing ledger data programmatically

  • Debugging ledger configurations

  • Integrating ledger data with other applications

FAQ from ledger-service MCP server

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?

The config file is located at ~/Library/Application\ Support/Claude/claude_desktop_config.json

Where is the Claude Desktop config file located on Windows?

The config file is located at %APPDATA%/Claude/claude_desktop_config.json