bexio-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bexio-mcp list my last 10 contacts"
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.
bexio MCP Server
English · Deutsch
A standalone Model Context Protocol (MCP) server for the bexio REST API. Usable from any MCP client — Claude Desktop, Claude Code, n8n and others.
The server depends on nothing but a bexio API token. No database, no framework, no host application.
Transports
Transport | For | Enable |
stdio (default) | Claude Desktop, Claude Code, CLI clients |
|
HTTP (Streamable HTTP) | n8n, remote clients, Docker |
|
Related MCP server: Moxie CRM MCP Server
Available tools (21)
Tool | Description |
| List with pagination ( |
| Single record by |
| Search with field criteria (POST |
| Company profile of the account |
| Create a contact (company or person) |
| Generic call for any bexio endpoint |
bexio_requestreaches every endpoint of the API (e.g./3.0/banking/accounts,/2.0/taxes,/2.0/kb_invoice/{id}/payment) and thus covers the entire API surface.
Example: search
{
"criteria": [{ "field": "name_1", "value": "Muster", "criteria": "like" }],
"limit": 50
}Operators: =, !=, >, <, >=, <=, like, not_like, is_null, not_null,
in, not_in.
Installation
cd bexio-mcp
npm install
npm run build
cp .env.example .env # set BEXIO_API_TOKENCreate a token: bexio → Settings → API & Webhooks → API tokens. The token's scope
determines which resources are readable/writable (e.g. contact_show, kb_invoice_show).
Claude Desktop (stdio)
claude_desktop_config.json (macOS:
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"bexio": {
"command": "node",
"args": ["/absolute/path/bexio-mcp/dist/index.js"],
"env": { "BEXIO_API_TOKEN": "your-token-here" }
}
}
}Claude Code (stdio)
claude mcp add bexio --env BEXIO_API_TOKEN=your-token -- node /absolute/path/bexio-mcp/dist/index.jsn8n (HTTP)
n8n speaks MCP over HTTP. Start the server in HTTP mode — easiest via Docker:
# fill .env with BEXIO_API_TOKEN and MCP_HTTP_TOKEN, then:
docker compose up -d --buildOr without Docker:
MCP_TRANSPORT=http MCP_HTTP_TOKEN=secret BEXIO_API_TOKEN=... node dist/index.jsIn the n8n workflow, add the "MCP Client Tool" node:
Endpoint / SSE URL:
http://<host>:3000/mcp(when n8n is on the same Docker network, e.g.http://bexio-mcp:3000/mcp)Transport: HTTP Streamable
Authentication / Header:
Authorization: Bearer secret(value ofMCP_HTTP_TOKEN)
Liveness check: GET http://<host>:3000/health → {"status":"ok"}.
Manual test of the HTTP endpoint
curl -X POST http://localhost:3000/mcp \
-H 'Authorization: Bearer secret' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'Environment variables
Variable | Default | Purpose |
| — (required) | bexio PAT or OAuth2 access token |
|
| API base URL |
|
|
|
|
| Port in HTTP mode |
|
| Bind host in HTTP mode |
| — | If set: required bearer token for |
Development
npm run watch # TypeScript watch mode
npm run inspect # MCP Inspector (interactive tool testing)Security
The bexio token grants full API access within its scopes — never commit it (
.envanddist/are in.gitignore).In HTTP mode always set
MCP_HTTP_TOKENwhen the port is reachable. Without it,/mcpis open — and so is your bexio account.
Privacy
This server stores no data. It forwards requests unchanged to the bexio REST API and returns the responses to the MCP client. There is no database, no logging of payload data, and no sharing with third parties. Processing of your bexio data is governed solely by bexio's privacy policy.
License
Released under the MIT License. © 2026 Valmir Emini.
Disclaimer & trademarks
This is an unofficial, independent open-source project. It is not affiliated with, endorsed by, sponsored by, or approved by bexio AG.
"bexio" is a trademark of bexio AG. All trademark and product names are the property of their respective owners and are used here solely for identification purposes.
The software is provided "as is", without warranty of any kind (see LICENSE). Use of the bexio API is at your own risk and subject to bexio AG's terms of use. The author accepts no liability for any damage or data loss arising from the use of this server.
Available Tools
21 toolsbexio_create_contactCreate a contactB
Create a contact in bexio (POST /2.0/contact). contact_type_id 1 = company, 2 = person. For a person, set name_1 = last name and name_2 = first name.
Inputs: name_1 (required), contact_type_id (required), city, mail, +8 more.
bexio_get_company_profileGet company profileA
Fetch the bexio company profile(s) of the authenticated account (GET /2.0/company_profile).
Inputs: no named parameters.
bexio_get_contactGet a contactB
Fetch a single contact by id (GET /2.0/contact/{id}).
Inputs: id (required).
bexio_get_invoiceGet a invoiceB
Fetch a single invoice by id (GET /2.0/kb_invoice/{id}).
Inputs: id (required).
bexio_get_itemGet a itemB
Fetch a single item by id (GET /2.0/article/{id}).
Inputs: id (required).
bexio_get_orderGet a orderB
Fetch a single order by id (GET /2.0/kb_order/{id}).
Inputs: id (required).
bexio_get_projectGet a projectA
Fetch a single project by id (GET /2.0/pr_project/{id}).
Inputs: id (required).
bexio_get_quoteGet a quoteA
Fetch a single quote by id (GET /2.0/kb_offer/{id}).
Inputs: id (required).
bexio_list_contactsList contactsB
List contacts from bexio (GET /2.0/contact). Supports pagination and ordering.
Inputs: limit, offset, order_by.
bexio_list_invoicesList invoicesB
List invoices from bexio (GET /2.0/kb_invoice). Supports pagination and ordering.
Inputs: limit, offset, order_by.
bexio_list_itemsList items / articlesA
List items / articles from bexio (GET /2.0/article). Supports pagination and ordering.
Inputs: limit, offset, order_by.
bexio_list_ordersList ordersA
List orders from bexio (GET /2.0/kb_order). Supports pagination and ordering.
Inputs: limit, offset, order_by.
bexio_list_projectsList projectsA
List projects from bexio (GET /2.0/pr_project). Supports pagination and ordering.
Inputs: limit, offset, order_by.
bexio_list_quotesList quotes / offersB
List quotes / offers from bexio (GET /2.0/kb_offer). Supports pagination and ordering.
Inputs: limit, offset, order_by.
bexio_requestRaw bexio API requestA
Make an arbitrary authenticated request to the bexio API. Use this for any endpoint not covered by a dedicated tool (e.g. /3.0/banking/accounts, /2.0/user, /2.0/taxes, /2.0/kb_invoice/{id}/payment). See https://docs.bexio.com/ for the full reference.
Inputs: path (required), method (required), body, query.
bexio_search_contactsSearch contactsB
Search contacts with field criteria (POST /2.0/contact/search).
Inputs: criteria (required), limit, offset, order_by.
bexio_search_invoicesSearch invoicesC
Search invoices with field criteria (POST /2.0/kb_invoice/search).
Inputs: criteria (required), limit, offset, order_by.
bexio_search_itemsSearch items / articlesB
Search items / articles with field criteria (POST /2.0/article/search).
Inputs: criteria (required), limit, offset, order_by.
bexio_search_ordersSearch ordersC
Search orders with field criteria (POST /2.0/kb_order/search).
Inputs: criteria (required), limit, offset, order_by.
bexio_search_projectsSearch projectsC
Search projects with field criteria (POST /2.0/pr_project/search).
Inputs: criteria (required), limit, offset, order_by.
bexio_search_quotesSearch quotes / offersC
Search quotes / offers with field criteria (POST /2.0/kb_offer/search).
Inputs: criteria (required), limit, offset, order_by.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a distinct resource-action pair (e.g., list vs. search vs. get for contacts, invoices, etc.), with no overlap. The generic request tool covers any missing endpoints, further reducing ambiguity.
All tools follow a consistent 'bexio_<verb>_<resource>' pattern in snake_case, with verbs like create, get, list, search, and request. Naming is predictable and uniform.
21 tools cover the main business objects (contacts, invoices, items, orders, projects, quotes) plus a generic request endpoint. This is well-scoped for an ERP system, avoiding fragmentation or sparseness.
Only create_contact exists; there are no create, update, or delete tools for invoices, orders, projects, quotes, or items. Agents can only read and search these resources, which severely limits workflows without the generic request tool.
Maintenance
Related MCP Connectors
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server to interact with the Cuéntica accounting API, allowing users to manage invoices, expenses, income, clients, providers, and bank accounts via natural language.592MIT
- AlicenseBqualityCmaintenanceAn MCP server that enables LLMs to interact with Moxie CRM. Provides comprehensive tools for managing clients, contacts, projects, invoices, time tracking, and more.3034 npm3MIT
- AlicenseBqualityDmaintenanceMCP server for Invoice Ninja v5 API. Enables AI assistants to manage clients, invoices, quotes, payments, and time tracking through natural language.3222 npm2MIT
- AlicenseAqualityCmaintenanceMCP server for the bexio API, enabling interaction with contacts, sales, accounting, projects, and more through 35 tools. Supports both PAT and OAuth authentication with read-only mode and tool group filtering.3514 npm4MIT