# BuchhaltungsButler

Connects BuchhaltungsButler accounting to AI assistants through 46 categorized tools. Manages invoices, bank bookings, and ledger reports directly from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: ohneben
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ohneben/Buchhaltungsbutler-MCP
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/buchhaltungsbutler

## What it does

The server exposes 54 endpoints of the BuchhaltungsButler API v1 as 46 MCP tools. It lets agents review open receipts and prepare invoice drafts. An internal limiter stays below the provider ceiling of 100 requests per minute.

Operations carry safety levels alongside machine-readable `readOnlyHint` and `destructiveHint` annotations. Hosts inspect these markers before executing changes. Destructive actions require manual approval.

Running the container requires Docker and environment keys: `BB_API_CLIENT`, `BB_API_SECRET`, and `BB_API_KEY`. Credentials stay private. The server injects them into outgoing API requests without leaking them to the model.

## Requirements
- Needs: Docker
- Environment variables: `MCP_TRANSPORT`, `BB_API_CLIENT`, `BB_API_SECRET`, `BB_API_KEY`, `BB_RATE_LIMIT`, `BB_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env BB_API_CLIENT=<BB_API_CLIENT> --env BB_API_SECRET=<BB_API_SECRET> --env BB_API_KEY=<BB_API_KEY> --env BB_RATE_LIMIT=<BB_RATE_LIMIT> --transport stdio buchhaltungsbutler -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add buchhaltungsbutler --env MCP_TRANSPORT=<MCP_TRANSPORT> --env BB_API_CLIENT=<BB_API_CLIENT> --env BB_API_SECRET=<BB_API_SECRET> --env BB_API_KEY=<BB_API_KEY> --env BB_RATE_LIMIT=<BB_RATE_LIMIT> -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "buchhaltungsbutler": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MCP_TRANSPORT",
                "-e",
                "BB_API_CLIENT",
                "-e",
                "BB_API_SECRET",
                "-e",
                "BB_API_KEY",
                "-e",
                "BB_RATE_LIMIT",
                "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>",
                "BB_API_CLIENT": "<BB_API_CLIENT>",
                "BB_API_SECRET": "<BB_API_SECRET>",
                "BB_API_KEY": "<BB_API_KEY>",
                "BB_RATE_LIMIT": "<BB_RATE_LIMIT>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "buchhaltungsbutler": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MCP_TRANSPORT",
                "-e",
                "BB_API_CLIENT",
                "-e",
                "BB_API_SECRET",
                "-e",
                "BB_API_KEY",
                "-e",
                "BB_RATE_LIMIT",
                "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>",
                "BB_API_CLIENT": "<BB_API_CLIENT>",
                "BB_API_SECRET": "<BB_API_SECRET>",
                "BB_API_KEY": "<BB_API_KEY>",
                "BB_RATE_LIMIT": "<BB_RATE_LIMIT>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e BB_API_CLIENT=<BB_API_CLIENT> -e BB_API_SECRET=<BB_API_SECRET> -e BB_API_KEY=<BB_API_KEY> -e BB_RATE_LIMIT=<BB_RATE_LIMIT> buchhaltungsbutler docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY -e BB_RATE_LIMIT ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.4
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- retrieve open incoming receipts from the previous month
- generate invoice drafts with hourly consulting fees
- reconcile incoming bank payments to ledger account 4400
- fetch quarterly BWA accounting summaries and account balances

## Example prompts
- List all open incoming receipts from last month.
- Create a draft invoice for ACME GmbH covering 10 hours of consulting at 120 EUR.
- Generate the BWA report for the last quarter and display ledger account 4400.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md