BuchhaltungsButler MCP-Server

A Model Context Protocol (MCP) server for the BuchhaltungsButler API. This allows you to use BuchhaltungsButler directly from Claude Desktop, ChatGPT, or any other MCP client.

Requirements

• Node.js ≥ 18

• BuchhaltungsButler API access (API Client + API Secret + API Key of a customer)

Related MCP server: MonKey Office MCP Server

Installation

git clone <repo-url>
cd buchhaltungsbutler-mcp
npm install
npm run build

Configuration

The following environment variables are required:

Optional:

Usage in Claude Desktop

1. Open the Claude Desktop configuration:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server:

{
  "mcpServers": {
    "buchhaltungsbutler": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/buchhaltungsbutler-mcp/dist/index.js"],
      "env": {
        "BUCHHALTUNGSBUTLER_API_CLIENT": "dein-api-client",
        "BUCHHALTUNGSBUTLER_API_SECRET": "dein-api-secret",
        "BUCHHALTUNGSBUTLER_API_KEY": "kunden-api-key"
      }
    }
  }
}

3. Restart Claude Desktop.

Usage in ChatGPT / Other Clients

This server uses the MCP stdio transport, which is natively supported by Claude Desktop. For ChatGPT or other clients, an MCP client bridge (e.g., mcp-proxy) is required to translate stdio to SSE/WebSocket:

npx mcp-proxy node /absoluter/pfad/zu/buchhaltungsbutler-mcp/dist/index.js

Available Tools

• Receipts: list_receipts, get_receipt, create_receipt, upload_receipt, delete_receipt

• Transactions: list_transactions, get_transaction, create_transaction, assign_receipt_to_transaction, unassign_receipt_from_transaction

• Invoices: create_invoice, create_invoice_draft

• Postings: list_postings, create_free_posting

• Master data: list_debtors, list_creditors, list_posting_accounts, create_debtor, create_creditor

• Other: list_accounts, add_comment, list_cost_locations, create_cost_location

The complete API documentation is available as api-spec.json in the project and can be compared with the official BuchhaltungsButler API docs.

Security

• API Client and Secret are confidential. Do not store them in the repository, only in the Claude Desktop configuration or in environment variables.

• The .gitignore excludes node_modules/, dist/, and .env.

Development

npm run dev     # TypeScript im Watch-Modus
npm run build   # Einmalig bauen
npm start       # Server starten

License

MIT