ledger-service MCP server

Name: ledger-service MCP server
Author: mprokopov

@mprokopov

リポジトリ

ledger-service MCP server について

MCP Server for my ledger

#ledger-mcp #ledger-service #mcp-server

基本情報

カテゴリ

その他

ライセンス

GPL-3.0

ランタイム

python

トランスポート

stdio

公開者

mprokopov

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "ledger-mcp-server": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "ledger-service"
      ]
    }
  }
}

ツール

Lists all accounts in the ledger

Gets the balance for a specific account

Shows the transaction register for an account

概要

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).