Skip to main content
Glama
kristianfreeman

hledger MCP Server

by kristianfreeman
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

hledger MCP Server

MCP server that gives Claude access to hledger commands for financial analysis.

Built with Claude Code.

Setup

  1. Install hledger: brew install hledger

  2. Clone and build this repo

  3. Set LEDGER_FILE=path/to/your.journal

  4. Configure Claude Desktop (see below)

git clone https://github.com/kristianfreeman/hledger-mcp-server
cd hledger-mcp-server
npm install
npm run build
export LEDGER_FILE=/path/to/your/main.journal

Related MCP server: Finance MCP Server

Available Commands

  • hledger_balance - Account balances

  • hledger_register - Transaction listing

  • hledger_accounts - List accounts

  • hledger_stats - Journal statistics

  • hledger_balancesheet - Balance sheet

  • hledger_incomestatement - Income statement

  • hledger_cashflow - Cash flow statement

Claude Configuration

Claude Code (CLI)

claude mcp add hledger-mcp-server -- node ./hledger-mcp-server/dist/index.js

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hledger": {
      "command": "node",
      "args": ["/absolute/path/to/hledger-mcp-server/dist/index.js"]
    }
  }
}

Then ask Claude: "Show me my account balances" or "What did I spend on groceries last month?"

License

MIT License - see LICENSE file for details.

Related Projects

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Beancount Tool

    onesvat
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with local Beancount accounting ledgers through structured tools for viewing accounts, balances, and transactions, as well as inserting/removing transactions and answering natural-language questions via BeanQuery. Provides deterministic, validated, and auditable financial data operations with offline-first functionality.
    1
    -

  • Finance MCP Server

    taylor3lewis
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables personal finance tracking through Claude Desktop using natural language to manage income and expenses with persistent SQLite storage. Supports adding and deleting transactions, checking balances, and viewing spending summaries grouped by category or month.
    -

  • personal-capital-connector-mcp

    meetv123
    F
    license
    A
    quality
    D
    maintenance
    Enables Claude to query Empower/Personal Capital financial accounts, net worth, transactions, and asset allocation via natural language.
    5
    -

  • Personal Finance MCP Server

    jahnavi-reddy03
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables Claude to analyze personal finances by reading bank CSVs or connecting to Plaid for live transactions, categorizing spending, flagging overspending against benchmarks, and generating actionable reports and savings tips.
    MIT