mprokopov_ledger-mcp-server

The ledger-service MCP server is designed to facilitate the management and access of ledger files through the Claude platform. It provides a structured way to interact with ledger data, offering tools to list accounts, check account balances, and view transaction registers. The server is built to integrate seamlessly with Claude Desktop, allowing users to configure and run the server with ease. It requires Python 3.13 or higher and utilizes the 'uv' package manager for installation and management. Debugging is supported through the MCP Inspector, which provides a user-friendly interface for troubleshooting and development.

Features

• Lists all accounts in the ledger for a specified year.
• Retrieves the balance for a specific account within a given year.
• Displays the transaction register for a specified account and year.

MCP Tools

• {'list-accounts': "Lists all accounts in the ledger, requires 'year' as an argument."}
• {'account-balance': "Gets the balance for a specific account, requires 'year' and 'account' as arguments."}
• {'account-register': "Shows the transaction register for an account, requires 'year' and 'account' as arguments."}

Usage with Different Platforms

install_from_pypi

bash
uv pip install ledger-service

debugging

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

configure_claude_desktop_mac

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

configure_claude_desktop_windows

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