Skip to main content
Glama
bexio-mcp

bexio-mcp

by valmiremini

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

MCP_TRANSPORT=stdio (default)

HTTP (Streamable HTTP)

n8n, remote clients, Docker

MCP_TRANSPORT=http or arg http

Related MCP server: Moxie CRM MCP Server

Available tools (21)

Tool

Description

bexio_list_contacts / _invoices / _quotes / _orders / _items / _projects

List with pagination (limit, offset, order_by)

bexio_get_contact / _invoice / _quote / _order / _item / _project

Single record by id

bexio_search_contacts / _invoices / _quotes / _orders / _items / _projects

Search with field criteria (POST /search)

bexio_get_company_profile

Company profile of the account

bexio_create_contact

Create a contact (company or person)

bexio_request

Generic call for any bexio endpoint

bexio_request reaches 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.

{
  "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_TOKEN

Create 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.js

n8n (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 --build

Or without Docker:

MCP_TRANSPORT=http MCP_HTTP_TOKEN=secret BEXIO_API_TOKEN=... node dist/index.js

In 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 of MCP_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

BEXIO_API_TOKEN

— (required)

bexio PAT or OAuth2 access token

BEXIO_API_BASE_URL

https://api.bexio.com

API base URL

MCP_TRANSPORT

stdio

stdio or http

MCP_HTTP_PORT / PORT

3000

Port in HTTP mode

MCP_HTTP_HOST

0.0.0.0

Bind host in HTTP mode

MCP_HTTP_TOKEN

—

If set: required bearer token for /mcp

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 (.env and dist/ are in .gitignore).

  • In HTTP mode always set MCP_HTTP_TOKEN when the port is reachable. Without it, /mcp is 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 tools
bexio_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

    A3.5/5.0

    Scored across 21 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server to interact with the Cuéntica accounting API, allowing users to manage invoices, expenses, income, clients, providers, and bank accounts via natural language.
      59
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for Invoice Ninja v5 API. Enables AI assistants to manage clients, invoices, quotes, payments, and time tracking through natural language.
      32
      22 npm
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP 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.
      35
      14 npm
      4
      MIT