Ledger MCP Server

by mprokopov

ledger-service MCP server

MCP Server for accessing and managing ledger files through Claude.

Components

Tools

The server implements three tools for ledger management:

  • list-accounts: Lists all accounts in the ledger
    • Takes "year" as a required argument
    • Returns formatted list of all available accounts
  • account-balance: Gets the balance for a specific account
    • Takes "year" and "account" as required arguments
    • Returns the current balance for the specified account
  • account-register: Shows the transaction register for an account
    • Takes "year" and "account" as required arguments
    • Returns detailed transaction history for the specified account

Installation

Prerequisites

  • Python 3.13 or higher
  • uv package manager
  • Node.js and npm (for debugging)

Install from PyPI

uv pip install ledger-service

Debugging

Using the inspector to debug the server:

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

Configure Claude Desktop

Add the server configuration to Claude Desktop's config file:

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Development

Local Setup

  1. Clone the repository
  2. Create and activate a virtual environment
  3. Install dependencies:

The base path can be configured by modifying the LEDGER_BASE_PATH constant in server.py.

License

GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.

  1. Components
    1. Tools
  2. Installation
    1. Prerequisites
    2. Install from PyPI
  3. Debugging
    1. Configure Claude Desktop
  4. Development
    1. Local Setup
  5. License

    Related MCP Servers

    • A
      security
      F
      license
      A
      quality
      An MCP server that connects Claude to BrianKnows' blockchain knowledge base, allowing users to search for blockchain/DeFi information and interact with a specialized agent across multiple knowledge bases.
      Last updated -
      3
      JavaScript
    • -
      security
      A
      license
      -
      quality
      A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
      Last updated -
      60
      TypeScript
      MIT License
      • Apple
      • Linux
    • A
      security
      A
      license
      A
      quality
      An MCP server that enables interaction with Safe (formerly Gnosis Safe) smart contract wallets, allowing users to query transactions, get multisig details, and decode transaction data through natural language.
      Last updated -
      3
      JavaScript
      MIT License
    • -
      security
      A
      license
      -
      quality
      An MCP server that provides seamless integration with the Neo N3 blockchain, allowing Claude to interact with blockchain data, manage wallets, transfer assets, and invoke smart contracts.
      Last updated -
      139
      2
      TypeScript
      MIT License
      • Linux
      • Apple

    View all related MCP servers

    ID: c4fin1c7jw