Bexio Mcp Server
Swiss accounting integration for Bexio. 315 tools: invoices, contacts, projects, account balances
Complete Swiss accounting integration for Bexio via the Model Context Protocol (MCP). Works with Claude Desktop, n8n, and any MCP-compatible client.
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!
Compatibility
| Client | Transport | Status |
|---|---|---|
| Claude Desktop | stdio | ✅ Fully supported |
| n8n | HTTP | ✅ Fully supported |
| Other MCP clients | stdio/HTTP | ✅ Should work |
Quick Start
For Claude Desktop
Option A: MCPB Bundle (Easiest)
- Download the latest
.mcpbfile from GitHub Releases - Install it in Claude Desktop, either way works:
- Double-click the
.mcpbfile (or drag it onto the Claude Desktop window), or - go to Settings → Extensions → Advanced settings, and under Extension Developer click Install Extension… and select the file
- Double-click the
- Enter your Bexio API token when prompted. It is stored in your operating system's keychain.
- Optional: switch on Interactive panels in the extension's settings for invoice previews, contact cards and a dashboard.
No 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:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Then 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.
For n8n and Other HTTP Clients
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.
For Other stdio Clients
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
Getting Your Bexio API Token
From the project's README.