HLedger MCP server

This is a helper that connects your AI assistant to hledger, a free plain text accounting program. Once it is set up, you can ask questions about your money in normal words instead of typing hledger commands. It is handy if you already keep your books in hledger and want a friendlier way to look things up or add entries.

What this MCP server does

You ask your AI a question about your books, like what you spent on food last month. The AI passes that request to this helper. The helper runs the matching hledger command on your journal file and reads the result. Then it hands the answer back to the AI, which explains it to you in the chat. If you allow writing, it can also add, change, or remove entries after checking them first.

Click to zoom

What you can do with it

• Check your account balances and account names
• Generate reports like a balance sheet, income statement, or cash flow
• Look through your transaction register and print entries
• See your top payees, tags, notes, and account activity
• Add a new transaction to your journal
• Find, replace, or remove an existing entry
• Open the hledger web view from inside the chat

Try asking your AI

• “What's my current account balance?”
• “Show me a balance sheet for last quarter”
• “What were my food expenses last month?”
• “Add a 42 dollar grocery expense from my checking account today”

What it gives back to you

You get answers in plain text in the chat, usually as a table or a short list. Reports come back as readable summaries, and you can ask for csv, json, or html if you want to save them. When it changes your journal, it tells you what it did and where. If you asked for a dry run, it shows you the change without saving it.

Before you start

Who it's for

People who already keep their books in hledger and want to ask questions or make entries in plain language instead of typing commands.