The io.github.PromptPartner/bexio-mcp-server provides a Swiss accounting integration for Bexio using the Model Context Protocol (MCP). It exposes 314 tools covering invoices, contacts, projects, and account balances, and is designed for use with MCP-compatible clients, including Claude Desktop and n8n.
π οΈ Key Features
Swiss accounting integration for Bexio
314 tools for invoices, contacts, projects, and account balances
Accessible via Model Context Protocol (MCP)
Supports Claude Desktop and n8n
π Use Cases
Manage Bexio invoices, contacts, and projects via AI conversation or workflow automation
Retrieve or work with account balances
Invoke accounting operations from any MCP-compatible client
β‘ Developer Benefits
Tool-driven MCP interface (314 tools) for automation and integrations
Works with both conversational clients and workflow tools (Claude Desktop, n8n)
β οΈ Limitations
Early release software: under active development; bugs or unexpected behavior may occur
Features are expected to be added and improved over time
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!
Double-click the .mcpb file (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
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:
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:
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_TOKEN the HTTP
endpoints are unauthenticated: on 0.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 unless BEXIO_FILE_DIR names 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.
Invoice is in draft status. Say "issue invoice INV-2024-015" to finalize it.
Example 3: Project Time Summary
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):
Team Member
Hours
Activities
Anna M.
24:30
Design, Meetings
Marco K.
18:15
Development
Lisa B.
8:00
Content Writing
Total: 50 hours 45 minutes
Budget used: 50.75 of 80 hours (63%)
Example 4: Customer Revenue Report
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.
Comma-separated tool-category whitelist β see below
BEXIO_HTTP_TOKEN
Recommended for HTTP
-
Bearer token required on every HTTP endpoint except GET /
BEXIO_FILE_DIR
No
-
Directory that upload_filefile_path / download_fileoutput_path are confined to. Required for local paths over HTTP; optional extra confinement over stdio
BEXIO_DOWNLOAD_INLINE_MAX_BYTES
No
64000
download_file returns files up to this size inline as base64; larger ones are written to disk
* Provide either BEXIO_API_TOKEN (one company) or BEXIO_API_TOKENS (several).
Reducing Token Budget β Category Whitelist
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:
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).
Multiple Companies (Mandates)
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):
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.
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.
Development Tools
The expansion from 83 to 314 tools was developed using:
GSD Framework - The "Get Shit Done" planning framework for structured AI-assisted development workflows
These tools helped transform a 4-weeks estimated project into a 2-days reality, demonstrating the potential of AI-augmented software development.
Disclaimer
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.