Beancount Tool

Acerca de

The Beancount Tool is an MCP server designed to offer a robust, offline-first interface for interacting with Beancount 3.2.0 ledgers. It exposes structured APIs for viewing accounts, balances, income sheets, and transactions, alongside capabilities for inserting, updating, and removing transactions. Emphasizing correctness, safety through file locking, atomic writes, and backups, and clear error messages, it also includes a natural-language Q&A layer that maps questions to safe, read-only BeanQuery templates, making financial data accessible to MCP-compatible clients like IDE agents or chat assistants.

Características Principales

• 0 GitHub stars
• Ensures data integrity with atomic writes, file locking, and automatic timestamped backups.
• Structured API for viewing accounts, balances, income sheets, and transactions.
• Insert and remove transactions with unique identifiers, validation, and dry-run mode.
• Execute read-only BeanQuery strings directly.
• Answer natural-language questions via rule/template-based mapping to BeanQuery.

Casos de Uso

• Integrating Beancount ledger data with AI agents or chat assistants for financial insights.
• Developing custom applications that interact with Beancount ledgers programmatically.
• Automating financial record-keeping and reporting for personal or small business use.