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
Debugging
Using the inspector to debug the server:
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
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
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
Related MCP Servers
- AsecurityFlicenseAqualityAn 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 -3JavaScript
- -securityAlicense-qualityA 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 -60TypeScriptMIT License
- AsecurityAlicenseAqualityAn 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 -3JavaScriptMIT License
- -securityAlicense-qualityAn 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 -1392TypeScriptMIT License