Beanquery MCP ServerServer

vanto
GitHub
financedata analysisMCP

Loading subscription status...

💡 Description

The Beanquery MCP Server is an experimental implementation of the Model Context Protocol (MCP) designed to interact with Beancount accounting files. Leveraging the Beancount Query Language (BQL) and the BeanQuery tool, this server enables seamless querying and analysis of financial data stored in Beancount format.

📝 JSON Entries

{
  "mcpServers": [
    {
      "Beanquery MCP Server": {
        "args": [
          "-v BEANCOUNT_LEDGER=$(pwd)/sample.bean",
          "--with beancount",
          "--with beanquery"
        ],
        "command": "mcp install server.py"
      }
    }
  ]
}

🛠️ Tools

set_ledger_filerun_query

Features

  • Integration with Beancount files
  • Usage of Beancount Query Language (BQL)
  • Supports Python environment setup with .env files

💬 Example Queries

  • Get a list of tables accessible with BQL
  • Execute a query against the loaded Beancount file