@iiatlas/hledger-mcp

Overview

Connects your AI assistant to HLedger, a plain-text accounting tool, so you can ask about transactions, balances, and reports instead of typing HLedger commands yourself. It runs locally against your existing HLedger files, so your financial data never leaves your machine. A good fit for freelancers and small business owners who already track their books in HLedger.

Best for

Best for
Freelancers and small business owners on HLedger who want to query their books by asking

Use cases

• Ask for a summary of recent transactions or account balances
• Generate a report without writing an HLedger command
• Check spending in a category before a purchase decision
• Get a quick books snapshot ahead of a client or tax conversation

How to use

Install

npx @iiatlas/hledger-mcp /path/to/your/master.journal

Tested with

Claude Desktop, ChatGPT

Example client config

{\n  "mcpServers": {\n    "hledger": {\n      "command": "npx",\n      "args": ["-y", "@iiatlas/hledger-mcp", "/path/to/your/master.journal"]\n    }\n  }\n}

Notes

@iiatlas/hledger-mcp is a local MCP server that bridges AI assistants with the HLedger command-line accounting tool. It translates natural language requests into HLedger CLI commands and returns structured results. Built in TypeScript, it runs on the user’s machine and requires a local HLedger installation.

56 stars on GitHub. Last updated 2026-02-28. Licensed MIT.

Use cases

• Query financial transactions from HLedger using natural language prompts
• Automate accounting tasks by integrating HLedger with MCP-compatible AI clients
• Generate reports or summaries of HLedger data without writing raw CLI commands

Pros

• Enables conversational access to HLedger data without leaving the assistant
• Open source and self-hosted, keeping financial data local
• Leverages existing HLedger setups with no data migration needed

Cons

• Requires running HLedger and the MCP server locally, adding setup overhead
• Limited to HLedger’s capabilities and data model
• Small community (56 stars) means less support and fewer contributions

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.