The mcp-server-ledger provides AI assistants with structured access to Ledger CLI, a powerful command-line accounting system. Built with Python using the FastMCP framework, it exposes nine tools that map directly to Ledger commands including balance reports, transaction registers, account listings, and budget analysis. The server requires a valid Ledger file path and includes security measures to prevent command injection. It's particularly valuable for users who want to analyze financial data, generate reports, and track budgets through natural language queries without leaving their AI assistant conversation.
Shows account balances with powerful filtering options. Inputs: query pattern, date ranges, display options. Returns: Formatted balance report.
Shows transaction register with detailed history. Inputs: query pattern, date ranges, sorting options. Returns: Formatted register report.
Lists all accounts in the ledger file. Input: optional query pattern. Returns: List of matching accounts.
Lists all payees from transactions. Input: optional query pattern. Returns: List of matching payees.
Lists all commodities (currencies) used. Input: optional query pattern. Returns: List of matching commodities.
Prints transactions in ledger format. Inputs: query pattern, date ranges. Returns: Formatted ledger entries.
Shows statistics about the ledger file. Input: optional query pattern. Returns: Statistical summary of the ledger.
Shows budget analysis. Inputs: query pattern, date ranges, reporting period. Returns: Budget report.
Runs a raw Ledger CLI command. Input: command arguments as a list of strings. Returns: Command output as text.
No reviews yet. Be the first to review!
Sign in to join the conversation
