Which integrations are available for this server?

Enables automated retrieval and parsing of Hetzner Cloud invoices, including fetching invoice PDFs, extracting structured data, and accessing line-item details. Provides programmatic access to the OpenCollective GraphQL API v2 to manage collectives, search accounts, process expenses, query ledger transactions, and handle member information.

How do I use OpenCollective MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OpenCollective MCP Server Submit the latest Hetzner invoice as an expense to my collective" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

OpenCollective MCP Server

A Model Context Protocol server that gives AI agents programmatic access to OpenCollective, Hetzner Cloud, and Cloudflare — enabling automated bookkeeping, collective management, and invoice handling without manual intervention.

What is it?

This MCP server exposes 22 tools that let AI agents interact with:

OpenCollective GraphQL API v2 — Manage collectives, submit expenses, process payments, query transactions, and handle members
Hetzner Cloud invoices — Automatically fetch, parse, and reconcile hosting invoices
Cloudflare billing — Track CDN and hosting costs via the billing history API

The Problem

If you run an OpenCollective-backed project with infrastructure on Hetzner, you face a tedious monthly ritual:

Log into Hetzner → navigate to invoices → download the PDF
Manually extract the amount, date, and line items
Log into OpenCollective → create a new expense → copy-paste the data
Submit and wait for approval

Repeat every month. Forever.

This MCP automates it.

Who is it for?

Open collective maintainers who want to automate expense workflows
DevOps engineers running infrastructure on Hetzner who track costs via OpenCollective
AI developers building agents that need to manage budgets, expenses, or financial reporting
Bookkeepers tired of copy-pasting invoice data between systems

What can it do?

OpenCollective Operations (13 tools)

Tool	What it does
`oc_get_account`	Get detailed info about any collective (balance, stats, social links)
`oc_search_accounts`	Search across all OpenCollective accounts
`oc_get_logged_in_account`	Get the authenticated user's account
`oc_edit_account`	Update collective profile (name, description, tags, currency)
`oc_get_members`	List members, backers, and their donation totals
`oc_list_expenses`	Query expenses with rich filters (status, type, date, tags)
`oc_get_expense`	Get full expense details by ID
`oc_create_expense`	Submit new expenses (INVOICE, RECEIPT, GRANT, etc.)
`oc_edit_expense`	Modify existing expenses
`oc_delete_expense`	Remove expenses
`oc_process_expense`	Approve, reject, pay, hold, or release expenses
`oc_list_transactions`	Query the ledger (credits/debits, linked expenses)
`oc_execute_graphql`	Escape hatch for any GraphQL operation

Hetzner Operations (6 tools)

Tool	What it does
`hetzner_list_invoices`	List all invoices (paginated)
`hetzner_get_invoice`	Get a specific invoice by ID
`hetzner_get_latest_invoice`	Fetch the most recent invoice
`hetzner_get_invoice_pdf`	Download invoice as PDF (base64)
`hetzner_parse_invoice_pdf`	Extract structured data from invoice PDF
`hetzner_get_invoice_details`	Get line-item breakdown from usage portal

Cloudflare Operations (3 tools)

Tool	What it does
`cloudflare_list_invoices`	List billing history (paginated). Auto-converts USD to EUR using historical ECB rates
`cloudflare_get_invoice`	Get a specific billing item by ID. Includes EUR conversion
`cloudflare_get_latest_invoice`	Fetch the most recent billing item. Returns `amount_cents_eur` ready for OpenCollective

The Monthly Bookkeeping Workflow

# 1. Fetch the latest Hetzner invoice invoice = hetzner_get_latest_invoice() # 2. Submit it as an expense to your collective oc_create_expense( account_slug="my-collective", description=f"Hetzner Cloud - {invoice['date']}", expense_type="INVOICE", payee_slug="my-org", items=[{ "description": f"Cloud services - {invoice['date']}", "amount_cents": invoice['amount_cents'], "currency": "EUR" }], tags=["hetzner", "hosting"] )

# For Cloudflare (automatically converts USD to EUR) invoice = cloudflare_get_latest_invoice() oc_create_expense( account_slug="my-collective", description=f"Cloudflare - {invoice['date']}", expense_type="INVOICE", payee_slug="my-org", items=[{ "description": f"Cloudflare services - {invoice['date']}", "amount_cents": invoice['amount_cents_eur'], # Already converted! "currency": "EUR" }], tags=["cloudflare", "hosting", "cdn"] )

That's it. One agent prompt = one booked expense.

What it's NOT

Not a replacement for human judgment — Expenses still need approval based on your collective's policies
Not a financial advisory tool — It moves data, not money; you control the payouts
Not limited to Hetzner — The oc_execute_graphql tool lets you run any OpenCollective operation, so you can manage Stripe payouts, Wise transfers, or budget forecasting
Not a GUI — It's a backend for AI agents; use the OpenCollective dashboard for manual tasks

Quick Start

1. Clone and install

git clone https://github.com/your-org/opencollective-mcp.git cd opencollective-mcp pip install -e .

2. Configure environment

Copy .env.example to .env and fill in:

cp .env.example .env # Edit .env with your credentials

Variable	Required for	How to get it
`OPENCOLLECTIVE_TOKEN`	Write operations	OpenCollective dashboard → For Developers → Personal Tokens
`HETZNER_ACCOUNT_EMAIL`	Hetzner invoice tools	Your Hetzner account email
`HETZNER_ACCOUNT_PASSWORD`	Hetzner invoice tools	Your Hetzner password
`HETZNER_TOTP_SECRET`	Hetzner invoice tools (if 2FA)	Shown when you enable 2FA
`CLOUDFLARE_API_TOKEN`	Cloudflare billing tools	Cloudflare dashboard → My Profile → API Tokens → Create Token with "Billing:Read" permission

3. Run the server

# Direct python -m opencollective_mcp # Or via installed script opencollective-mcp

4. Connect to Claude Desktop

Add to your ~/.claude.json:

{ "mcpServers": { "opencollective": { "command": "python", "args": ["-m", "opencollective_mcp"], "env": { "OPENCOLLECTIVE_TOKEN": "your-token", "HETZNER_ACCOUNT_EMAIL": "you@example.com", "HETZNER_ACCOUNT_PASSWORD": "your-password", "CLOUDFLARE_API_TOKEN": "your-cloudflare-token" } } } }

Why build this?

Because infrastructure costs should be visible, automated, and auditable — exactly what OpenCollective provides for open source projects.

We built this to solve our own bookkeeping pain: tracking Hetzner hosting costs for Going Dark and automatically submitting them as expenses each month. Now our AI agent does it.

If you run a collective with cloud infrastructure, this saves you 15–30 minutes every month — and eliminates human error from manual data entry.