@promptpartner/bexio-mcp-server
Complete Swiss accounting integration for Bexio via the Model Context Protocol (MCP). Works with Claude Desktop, n8n, and any MCP-compatible client.
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y @promptpartner/[email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add promptpartner-bexio-mcp-server -- npx -y @promptpartner/bexio-mcp-server@2.6.2In einem Terminal ausführen.
{ "mcpServers": { "promptpartner-bexio-mcp-server": { "command": "npx", "args": [ "-y", "@promptpartner/[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Complete Swiss accounting integration for Bexio via the Model Context Protocol (MCP). Works with Claude Desktop, n8n, and any MCP-compatible client.
Complete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 314 tools for invoices, contacts, projects, time tracking, account balances and more.
Manage invoices, contacts, projects, time tracking, and 300+ more tools through AI conversation or workflow automation.
⚠️ Early Release Software
This project is under active development. While it's functional and tested, you may encounter bugs or unexpected behavior. Features will continue to be added and improved over time. Please report any issues you find!
Option A: MCPB Bundle (Easiest)
.mcpb file from GitHub Releases.mcpb file (or drag it onto the Claude Desktop window), orNo Node.js installation is needed: Claude Desktop runs extensions with its built-in Node.js. Updating from 2.6.1 or older? Re-enter your token if Claude Desktop asks for it.
Option B: npm (manual config)
Requires Node.js (LTS). In Claude Desktop, open Settings → Developer → Edit Config and add:
{
"mcpServers": {
"bexio": {
"command": "npx",
"args": ["-y", "@promptpartner/bexio-mcp-server"],
"env": {
"BEXIO_API_TOKEN": "your-token-here"
}
}
}
}
Config location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonThen quit Claude Desktop completely and restart it. Note that this file keeps your token in plain text; the extension (Option A) stores it in the keychain instead.
Start the server in HTTP mode, with a bearer token:
BEXIO_API_TOKEN=your-token BEXIO_HTTP_TOKEN=$(openssl rand -hex 32) \
npx @promptpartner/bexio-mcp-server --mode http --host 127.0.0.1 --port 8000
Clients then send Authorization: Bearer <BEXIO_HTTP_TOKEN> on every request (GET /,
the health check, stays open).
Security: every tool reads or changes your books. Without
BEXIO_HTTP_TOKENthe HTTP endpoints are unauthenticated: on0.0.0.0(the default) anyone who can reach the port can use them, and because CORS allows any origin, even a loopback-only server can be called by a web page open in your browser. The server warns at startup when no token is set. Local file paths (upload_filefile_path,download_fileoutput_path) are refused over HTTP unlessBEXIO_FILE_DIRnames a directory to confine them to.
The server exposes MCP over HTTP at http://localhost:8000. Configure your MCP client to connect to this endpoint.
BEXIO_API_TOKEN=your-token npx @promptpartner/bexio-mcp-server
Or build from source:
git clone https://github.com/PromptPartner/bexio-mcp-server
cd bexio-mcp-server/src
npm install && npm run build
BEXIO_API_TOKEN=your-token node dist/index.js
This MCP server provides 315 tools across all Bexio domains:
Here are some real-world examples of using the Bexio MCP server with Claude:
Prompt:
"Show me all overdue invoices"
What happens:
Claude uses the get_overdue_invoices tool to query Bexio for all invoices past their due date.
Response:
Found 3 overdue invoices:
Total overdue: CHF 8,540.50
Prompt:
"Create an invoice for contact 'Sunrise AG' with two items: 10 hours of consulting at CHF 150/hour and a software license for CHF 500"
What happens:
Claude uses find_contact_by_name to locate the customer, then create_invoice with the specified line items.
Response:
Created Invoice INV-2024-015 for Sunrise AG:
- 10x Consulting Hours @ CHF 150.00 = CHF 1,500.00
- 1x Software License @ CHF 500.00 = CHF 500.00
Subtotal: CHF 2,000.00 VAT (8.1%): CHF 162.00 Total: CHF 2,162.00
Invoice is in draft status. Say "issue invoice INV-2024-015" to finalize it.
Prompt:
"How much time was logged on project 'Website Redesign' this month?"
What happens:
Claude uses search_projects to find the project, then search_timesheets to get time entries filtered by project and date range.
Response:
Time logged on "Website Redesign" (January 2024):
Total: 50 hours 45 minutes
Budget used: 50.75 of 80 hours (63%)
Prompt:
"What's my revenue from 'Tech Solutions GmbH' this year?"
What happens:
Claude uses find_contact_by_name to identify the customer, then get_customer_revenue_report to calculate total revenue from paid invoices.
Response:
Revenue from Tech Solutions GmbH (2024):
- Q1: CHF 12,450.00 (3 invoices)
- Q2: CHF 8,200.00 (2 invoices)
- Q3: CHF 15,800.00 (4 invoices)
- Q4: CHF 6,500.00 (2 invoices, 1 pending)
Total paid: CHF 42,950.00 Pending: CHF 3,200.00
* Provide either BEXIO_API_TOKEN (one company) or BEXIO_API_TOKENS (several).
All tools are registered by default. For focused workflows or smaller models,
registering only a subset reduces the system-prompt token cost. Set
BEXIO_ENABLED_CATEGORIES to a comma-separated list:
BEXIO_ENABLED_CATEGORIES=contacts,invoices,purchase,banking,quotes,projects
Available categories: reference, company, banking, projects,
timetracking, accounting, purchase, files, payroll, contacts,
invoices, orders, quotes, payments, reminders, deliveries,
items, reports, users, misc, notes, tasks, stock, docs,
positions. Unknown names are ignored (logged to stderr); empty/unset = all
enabled (backward compatible).
Bexio binds each API token to a single company (mandate) — there is no token that
spans companies. To work with several companies, generate one token per company (switch
to that company in Bexio first, then Settings → API Tokens), and configure them all on a
single server instance. Two new tools — list_companies and select_company — let
you switch the active company in conversation ("in Globex, list open invoices"). This
avoids running one server per company and the duplicated tool-context that comes with it.
Set BEXIO_API_TOKENS instead of (or alongside) BEXIO_API_TOKEN, as a comma-separated
list of label:token pairs (or a JSON object). BEXIO_DEFAULT_COMPANY picks the company
active at startup (defaults to the first):
{
"mcpServers": {
"bexio": {
"command": "npx",
"args": ["@promptpartner/bexio-mcp-server"],
"env": {
"BEXIO_API_TOKENS": "Acme:token-for-acme,Globex:token-for-globex",
"BEXIO_DEFAULT_COMPANY": "Acme"
}
}
}
}
Then just ask Claude things like "switch to Globex and show this month's invoices."
list_companies shows the configured companies and which one is active; in
multi-company mode each response also notes the active_company so it's always clear
which company a result came from. Tokens are never logged or returned. The two control
tools appear only when BEXIO_API_TOKENS is set, so single-company setups are unchanged.
HTTP/n8n note: the active company is process-global. For concurrent multi-tenant HTTP deployments, run one instance per company instead.
npx @promptpartner/bexio-mcp-server [options]
Options:
--mode <stdio|http> Transport mode (default: stdio)
--host <address> HTTP host (default: 0.0.0.0)
--port <number> HTTP port (default: 8000)
~/Library/Logs/Claude/mcp-server-*.log (macOS) or %APPDATA%\Claude\logs (Windows)This MCP server acts as a pass-through to the Bexio API and does not store any data. For full details, see our Privacy Policy.
Your data is processed according to Bexio's Privacy Policy.
If this project saves you time or helps your business, consider buying me a coffee! ☕
Your support helps keep this project maintained and improved!
Created by Lukas Hertig from PromptPartner.ai
This project builds upon the original Bexio MCP server created by Sebastian Bryner of bryner.tech. His v1.0 implementation provided the foundational architecture and initial 83 tools that made this expanded v2.0 possible.
The expansion from 83 to 314 tools was developed using:
These tools helped transform a 4-weeks estimated project into a 2-days reality, demonstrating the potential of AI-augmented software development.
This is an independent, community-driven project and is not affiliated with, endorsed by, or officially connected to Bexio AG in any way. "Bexio" is a trademark of Bexio AG. This project simply provides an integration layer to the publicly available Bexio API.
Use of this software is at your own risk. The authors are not responsible for any issues arising from its use with your Bexio account.
MIT - See LICENSE for details.
Complete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 314 tools for invoices, contacts, projects, time tracking, account balances and more.
{ "mcpServers": { "promptpartner-bexio-mcp-server": { "command": "npx", "args": [ "-y", "@promptpartner/[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
@promptpartner/bexio läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Complete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 314 tools for invoices, contacts, projects, time tracking, account balances and more.