Content
# 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
```bash
uv pip install ledger-service
```
## Debugging
Using the inspector to debug the server:
```bash
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`
<details>
<summary>Development Configuration</summary>
```json
"mcpServers": {
"ledger-service": {
"command": "uv",
"args": [
"--directory",
"/path/to/ledger-service",
"run",
"ledger-service"
]
}
}
```
</details>
<details>
<summary>Production Configuration</summary>
```json
"mcpServers": {
"ledger-service": {
"command": "uvx",
"args": [
"ledger-service"
]
}
}
```
</details>
## 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
Connection Info
You Might Also Like
MarkItDown MCP
Converting files and office documents to Markdown.
Filesystem
Model Context Protocol Servers
Sequential Thinking
Offers a structured approach to dynamic and reflective problem-solving,...
TrendRadar
🎯 Say goodbye to information overload. AI helps you understand news hotspots...
Github
GitHub's official MCP Server
opik
Debug, evaluate, and monitor your LLM applications, RAG systems, and agentic...