Ledger MCP Server

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

MCP Inspector debugging interface

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

Clone the repository
Create and activate a virtual environment
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

This server cannot be installed

security - not tested

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

BrianKnows MCP Server
antoncoding
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
MCP Tools for Obsidian
jacksteamdev
-
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
Safe MCP Server
5ajaki
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
Neo N3 MCP Server
r3e-network
-
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 -
82
3
TypeScript
MIT License

View all related MCP servers