ModelsAtlas
Explore
Atlas / MCP servers / minhyeoky / Ledger CLI

Ledger CLISAFE

mcp/minhyeoky/ledger-cli
MCP server by minhyeoky · Audited 2026-10-08
⚑ Report / re-scanSource ↗

A Model Context Protocol server for interacting with Ledger CLI, a powerful double-entry accounting system. This server enables Large Language Models to query and analyze financial data through a standardized interface, making it easy for AI assistants to help with financial reporting, budget analys

Verdict
SAFE
Grade
B
Trust score
89 /100
Exposed tools
9 9r · 0w · 0d
Transport
—
License
—
Stars
51
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://mseep.ai/app/minhyeoky-mcp-server-ledger)

[](https://smithery.ai/server/@minhyeoky/mcp-ledger)

Overview

A Model Context Protocol server for interacting with Ledger CLI, a powerful, double-entry accounting system accessible from the command line. This server allows Large Language Models to query and analyze your financial data through the Ledger CLI tool.

This MCP server exposes Ledger CLI's functionality through a standardized interface, making it easy for AI assistants to help you with financial reporting, budget analysis, and accounting tasks.

Features

The server provides the following tools that map to Ledger CLI commands:

  1. ledger_balance
  2. Shows account balances with powerful filtering options
  3. Inputs: query pattern, date ranges, display options
  4. Returns: Formatted balance report
  1. ledger_register
  2. Shows transaction register with detailed history
  3. Inputs: query pattern, date ranges, sorting options
  4. Returns: Formatted register report
  1. ledger_accounts
  2. Lists all accounts in the ledger file
  3. Input: optional query pattern
  4. Returns: List of matching accounts
  1. ledger_payees
  2. Lists all payees from transactions
  3. Input: optional query pattern
  4. Returns: List of matching payees
  1. ledger_commodities
  2. Lists all commodities (currencies) used
  3. Input: optional query pattern
  4. Returns: List of matching commodities
  1. ledger_print
  2. Prints transactions in ledger format
  3. Inputs: query pattern, date ranges
  4. Returns: Formatted ledger entries
  1. ledger_stats
  2. Shows statistics about the ledger file
  3. Input: optional query pattern
  4. Returns: Statistical summary of the ledger
  1. ledger_budget
  2. Shows budget analysis
Read from source at commit 51ad97b00936OBSERVED · 2026-10-08
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code
claude mcp add mcp-server-ledger -- uvx mcp-server-ledger
claude-desktop
{
  "mcpServers": {
    "mcp-server-ledger": {
      "command": "uvx",
      "args": [
        "mcp-server-ledger"
      ]
    }
  }
}
03

Exposed tools (9)

9 read · 0 write · 0 destructive.

ToolRiskDescription
ledger_accountsreadcmd = [
ledger_balancereadcmd = [
ledger_budgetreadcmd = [
ledger_commoditiesreadcmd = [
ledger_payeesreadcmd = [
ledger_printreadcmd = [
ledger_raw_commandreadreturn run_ledger(params.command)
ledger_registerreadcmd = [
ledger_statsreadcmd = [
04

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (1 observation(s))
Network
none-observed
Shell
none-observed
Dependencies
pinned
Secrets in source
none-found

Findings (1)

LOWInventory / provenance · inv.no_license · CWE-1104
Why it matters. no LICENSE file and no repo licence
Fix. add a licence

Gates applied: no_behavioural_pass, no_license.

Audited 2026-10-08 · audit v0.4.1 · source sha 51ad97b00936full audit observations/trust-audit/mcp-server/minhyeoky__ledger-cli.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-0851ad97b00936SAFEB89first audit
06

Questions

What is the Ledger CLI MCP server?

A Model Context Protocol server for interacting with Ledger CLI, a powerful double-entry accounting system. This server enables Large Language Models to query and analyze financial data through a standardized interface, making it easy for AI assistants to help with financial reporting, budget analys

What tools does Ledger CLI expose?

9 in total: 9 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is Ledger CLI safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.

What credentials does Ledger CLI need?

No credential environment variables were found in its source, so it appears to need none.

How current is this page?

The grade is for one exact copy of the source (51ad97b00936), read on 2026-10-08. The repository is watched and re-audited when it changes.

Advertisement