Finance · Developer Tools

Hledger MCP

iiatlas/hledger-mcp

A Model Context Protocol (MCP) server that provides AI assistants (MCP Clients) with direct access to HLedger accounting data and functionality. This server enables AI applications to query account balances, generate financial reports, add new entires, and analyze accounting data through a standardized protocol.

Install

Client configuration

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

Environment variables

HLEDGER_READ_ONLYHLEDGER_EXECUTABLE_PATHHLEDGER_WEB_EXECUTABLE_PATH
Author
@iiatlas
Category
Finance, Developer Tools
License
MIT
Updated
Oct 6, 2026

About Hledger MCP

It has support for most hledger cli commands, the ability to fetch an traverse include'd journal files, and a safe --read-only mode. I hope you find it useful!

Features

  • Accounts - List and query account names and structures

  • Balance - Generate balance reports with extensive customization options

  • Register - View transaction registers and posting details

  • Print - Output journal entries and transactions

  • Balance Sheet - Generate balance sheet reports

  • Balance Sheet Equity - Balance sheet reports with equity details

  • Income Statement - Profit & loss statements

  • Cash Flow - Cash flow analysis and reports

  • Stats - Statistical analysis of journal data

  • Activity - Account activity and transaction frequency analysis

Tools (9)

  • hledger_add_transaction

    accepts structured postings and appends a new transaction after validating with hledger check.

  • hledger_remove_entry

    deletes a transaction by exact text and location, re-validating with hledger check and respecting optional backups.

  • hledger_replace_entry

    swaps an existing entry for new content, keeping spacing tidy and performing a validation pass before committing.

  • hledger_import

    wraps hledger import, running the command against a temporary copy of the journal.

  • hledger_rewrite

    runs hledger rewrite on a temporary copy, letting you specify one or more addPostings instructions for matching transactions.

  • hledger_close

    produces closing/opening assertions, retain-earnings, or clopen transactions via hledger close.

  • hledger_web

    launches the hledger web UI/API on a free port unless a specific port/socket is supplied.

  • hledger_web_list

    returns metadata for each active web instance started by this MCP session (PID, command, base URL, access mode, etc.).

  • hledger_web_stop

    stops a selected instance by instanceId, pid, or port, or stops everything with all=true.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Stripe Agent Toolkit logo

Stripe Agent Toolkit

stripe/agent-toolkit

677

It contains a collection of SDKs to help you integrate Stripe with LLMs and agent frameworks, including.

Finance
Awesome Web3 MCP Servers logo

Awesome Web3 MCP Servers

demcp/awesome-web3-mcp-servers

405

MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.

Finance
Financial Datasets logo

Financial Datasets

financial-datasets/mcp-server

225

This is a Model Context Protocol (MCP) server that provides access to stock market data from Financial Datasets.

Finance
lyraios logo

lyraios

GalaxyLLMCI/lyraios

216

LYRAI is a Model Context Protocol (MCP) operating system for multi-AI AGENTs designed to extend the functionality of AI applications (such as Claude Desktop and Cursor) by enabling them to interact with financial networks and blockchain public chains.

Finance
EVM Blockchain logo

EVM Blockchain

mcpdotdirect/evm-mcp-server

216

A comprehensive Model Context Protocol (MCP) server that provides blockchain services across 60+ EVM-compatible networks. This server enables AI agents to interact with Ethereum, Optimism, Arbitrum, Base, Polygon, and many other EVM chains with a unified interface through 22 tools and 10 AI-guided prompts.

Finance
longport logo

longport

longportapp/openapi

206

Longport OpenAPI provides programmatic quote trading interfaces for investors with research and development capabilities and assists them to build trading or quote strategy analysis tools based on their own investment strategies. The functions fall into the following categories.

Finance