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

How are these scores calculated?

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

mysqldb-mcp-server
burakdirin
A
security
A
license
A
quality
An MCP server that enables MySQL database integration with Claude. You can execute SQL queries and manage database connections.
Last updated -
2
7
Python
MIT License
GOAT MCP Server
cryptoleek-team
-
security
F
license
-
quality
An MCP server that connects Claude for Desktop with blockchain functionality, allowing users to check balances and send tokens on EVM and Solana chains through natural language interactions.
Last updated -
TypeScript
MCP Log Reader
klara-research
A
security
A
license
A
quality
A specialized MCP server that helps analyze and debug Model Context Protocol logs by providing Claude with direct access to log files across multiple platforms.
Last updated -
1
12
TypeScript
MIT License
Sherlock Domains MCP
Fewsats
-
security
F
license
-
quality
An MCP server that enables users to buy and manage domains through Claude.
Last updated -
1
Python

View all related MCP servers