Beancount

You can run a Beancount MCP Server that can perform beancount queries and submit transactions to your ledger. It supports running as a local stdio service or exposed via an MCP URL for remote clients, making it easy to integrate with tooling like Claude and other MCP-enabled clients.

How to use

To use the Beancount MCP Server, start the local stdio version or connect to the remote MCP URL as configured. The server can execute beancount queries against your ledger and submit resulting transactions back to the ledger when required. In practical terms, you run the server locally with a ledger file and then point your MCP client at it, or you configure a remote MCP endpoint for clients to connect to.

How to install

Prerequisites: ensure you have a runtime environment that supports MCP commands (for example, the uvx launcher is used to run MCP servers). You will also need access to a Beancount ledger file with a .bean extension.

Step 1: Prepare your environment and ledger file. Make sure your ledger file path is accessible to the MCP server.

Step 2: Install and run the local stdio MCP server using the following command pattern. Replace PATH_TO_YOUR_LEDGER with the path to your ledger file.

Additional sections

MCP connections are provided in two forms: a remote HTTP endpoint and a local stdio server. Use the form that matches how you want to integrate with clients.

{
  "mcpServers": {
    "beancount_mcp_http": {
      "type": "http",
      "name": "beancount_mcp_http",
      "url": "https://github.com/StdioA/beancount-mcp/tree/master",
      "args": []
    }
  }
}

Additionally, you can run a local stdio MCP server using the following runtime command. This is useful for tight IDE integrations or local tooling that communicates via stdio.

{
  "mcpServers": {
    "beancount_mcp_stdio": {
      "type": "stdio",
      "name": "beancount_mcp_stdio",
      "command": "uvx",
      "args": [
        "beancount-mcp",
        "--transport=stdio",
        "PATH_TO_YOUR_LEDGER"
      ]
    }
  }
}

Available tools

query

Execute beancount queries against the connected ledger to retrieve balances, entries, or custom reports.

submit

Submit transactions to the ledger as generated by MCP operations or user-driven actions.