Skip to main content
Glama
@aiwerk/mcp-server-bexio

@aiwerk/mcp-server-bexio

by AIWerk

@aiwerk/mcp-server-bexio

MCP server for the bexio API, the Swiss business software for invoicing, accounting, CRM, projects and payroll.

310 tools covering the complete public API surface across all three API versions, generated from bexio's official OpenAPI 3.0.2 specification.

Contacts        Quotes        Invoices       Bills          Projects
Orders          Deliveries    Payments       Expenses       Timesheets
Items           Reminders     Banking        Payroll        Files
Accounting      Taxes         Currencies     Users          Notes

Why generated

Every endpoint, HTTP verb, parameter and field name comes from the official specification rather than from prose documentation. Hand written API clients drift: they call routes that do not exist, use the wrong verb, target the wrong API version, or advertise fields the server rejects. None of that can be introduced here, because none of it is written by hand.

What a specification cannot tell you are the business rules, so the write paths are also exercised against a live account. See Testing.

Related MCP server: mcp-server-smallinvoice

Install

npm install -g @aiwerk/mcp-server-bexio

Requires Node.js 18 or newer.

Authentication

There are two ways in, and which one is appropriate depends on whose account it is.

OAuth 2.0, for an account you do not own

bexio runs its identity layer on Keycloak with PKCE and refresh tokens. Signing in grants only the permissions the integration asks for, and the authorisation does not expire on a fixed schedule.

This is the only appropriate route for a client's account. It is available through the AIWerk hosted service, which owns the authorisation flow and the token lifecycle and passes the access token to the server in BEXIO_API_TOKEN. Running the server standalone with your own OAuth client is possible, but you have to refresh the token yourself.

Personal access token, for your own account

Create one at developer.bexio.com/pat.

export BEXIO_API_TOKEN="your-token"

Two things to know:

  • It is valid for 60 days and cannot be renewed, only replaced.

  • It carries every scope, so it grants full access to the company data. bexio documents personal access tokens as strictly personal and not to be shared, so do not ask a client for theirs.

The server accepts either kind of token in the same variable, since both are sent as a bearer credential.

Usage

Claude Code

claude mcp add bexio --env BEXIO_API_TOKEN=your-token -- npx -y @aiwerk/mcp-server-bexio

Claude Desktop

{
  "mcpServers": {
    "bexio": {
      "command": "npx",
      "args": ["-y", "@aiwerk/mcp-server-bexio"],
      "env": { "BEXIO_API_TOKEN": "your-token" }
    }
  }
}

AIWerk hosted service

Install it from the catalogue at aiwerkmcp.com and add your token in the interface. No local setup required.

Safety features

Accounting data is not a good place to find out that a tool did something unexpected, so three guards ship by default.

Dry run

export BEXIO_DRY_RUN=1

Every write is stopped inside the process and returns a description of the request that would have been sent. Reads still work normally. Useful for letting an agent plan a change before you allow it to happen.

Pre write snapshots

Before modifying or deleting an existing record, the server fetches its current state and writes it to ~/.aiwerk/bexio-snapshots/. The tool result carries the file path in _snapshot, so the previous state is always recoverable.

Several bexio edit endpoints replace the whole record, which means an omitted field becomes empty. The snapshot is what makes that reversible.

If the snapshot cannot be taken, the write is refused. Set BEXIO_SNAPSHOT_FAIL_OPEN=1 to downgrade that to a warning, or BEXIO_NO_SNAPSHOT=1 to switch snapshots off entirely.

Rate limit handling

bexio applies a per minute limit per company, and the limit is not the same for every endpoint. Measured against a live account, the items endpoint allows 400 requests per minute while contacts, accounts and currencies allow 1000.

The server therefore tracks the remaining allowance separately for each endpoint group, waits out short windows, retries on 429 with the reset hint, and fails with a clear message rather than hanging when the wait would be long.

Configuration

Variable

Default

Purpose

BEXIO_API_TOKEN

required

Personal access token

BEXIO_API_BASE_URL

https://api.bexio.com

Override the host, applies to all API versions

BEXIO_API_TIMEOUT_MS

30000

Per request timeout

BEXIO_DRY_RUN

off

1 blocks all writes

BEXIO_NO_SNAPSHOT

off

1 disables pre write snapshots

BEXIO_SNAPSHOT_FAIL_OPEN

off

1 allows a write when the snapshot fails

BEXIO_SNAPSHOT_DIR

~/.aiwerk/bexio-snapshots

Where snapshots are written

BEXIO_MAX_RATE_LIMIT_WAIT_MS

10000

Longest wait before failing on a rate limit

BEXIO_ENABLED_TAGS

all

Comma separated domain filter, for example Contacts,Invoices

Narrowing the tool set

All 310 tools are registered by default. A client that prefers a smaller surface can restrict the server to specific domains:

export BEXIO_ENABLED_TAGS="Contacts,Invoices,Quotes,Items"

Unknown domain names are reported on startup rather than silently ignored.

Tool naming

Tools follow a predictable shape, so an agent that knows one name can guess the rest:

list_contacts      get_contact      create_contact
search_contacts    update_contact   delete_contact

Collection verbs (list_, search_) take a plural noun, single record verbs take a singular one. Document actions keep their own verb: issue_invoice, cancel_invoice, send_invoice, mark_as_sent_invoice, revert_issue_quote.

A few bexio specifics worth knowing

  • Three API versions coexist. Contacts, sales documents, items and projects live on 2.0, files and expenses on 3.0, bills and banking on 4.0. The server handles this transparently, but it explains why paths look inconsistent in error messages.

  • Document positions require a tax id. The specification does not mark tax_id as required, yet bexio rejects a position without one. Fetch a valid id with list_taxes.

  • A 403 does not always mean permissions. bexio also answers 403 when the record's state forbids the operation, for example deleting an invoice that has been issued.

  • A contact's address is readable but not writable. Reading a contact returns a combined address ("Alte Jonastrasse 24") next to the split fields, but a write only accepts street_name, house_number, postcode and city. Reading a contact and sending it straight back is rejected with 422.

  • contact_type_id is 1 for a company and 2 for a person.

Testing

npm test          # unit tests
npm run smoke     # read only, against a live account

The write paths are covered by a separate script that creates and deletes real records, so it refuses to run without an explicit confirmation:

BEXIO_WRITE_SMOKE=yes node scripts/write-smoke.mjs

Point it at a throwaway trial account, never at production data. It exercises the full lifecycle of contacts, items, invoices and quotes, then removes what it can.

It cannot remove everything. Issuing an invoice consumes a number from the account's document sequence, and bexio then refuses to delete that document, which is the correct behaviour for an accounting system. Every run therefore leaves two cancelled invoices behind. On a real ledger that trace is permanent.

Development

The tool layer is generated and must not be edited by hand:

npm run gen-naming   # specification  ->  tool names
npm run gen-tools    # specification  ->  zod schemas and call sites
npm run build

Licence

MIT, see LICENSE.

Built by AIWerk. Not affiliated with bexio AG.

Available Tools

310 tools
archive_projectC

Archive a project

Inputs: project_id (required).

bulk_create_contactsC

Bulk create contacts

Inputs: body (required).

cancel_invoiceC

Cancel an invoice

Inputs: invoice_id (required).

cancel_paymentC

Cancel a payment

Inputs: payment_id (required).

copy_invoiceD

Copy a invoice

Inputs: contact_id (required), invoice_id (required), title, is_valid_from, +1 more.

copy_quoteC

Copy a quote

Inputs: quote_id (required), contact_id (required), title, is_valid_from, +2 more.

create_absence_for_employeeB

Create absence for employee

Inputs: reason (required), employeeId (required), start_date (required), end_date, +4 more.

create_accept_quoteC

Accept a quote

Inputs: quote_id (required).

create_additional_addressC

Create additional address

Inputs: contact_id (required), city, name, subject, +7 more.

create_billC

Create new Bill

Inputs: address (required), due_date (required), item_net (required), bill_date (required), +16 more.

create_bill_actionC

Execute Bill action

Inputs: id (required), action (required).

create_business_activityD

Create business activity

Inputs: name (required), account_id, default_is_billable, default_price_per_hour.

create_calendar_yearC

Create calendar year.

Inputs: year, is_vat_subject, is_annual_reporting, vat_accounting_type, +3 more.

create_commentD

Create a comment

Inputs: text (required), user_id (required), user_name (required), document_id (required), +3 more.

create_contactD

Create contact

Inputs: name_1 (required), user_id (required), owner_id (required), contact_type_id (required), +24 more.

create_contact_groupC

Create contact group

Inputs: name (required).

create_contact_relationC

Create contact relation

Inputs: contact_id (required), contact_sub_id (required), description.

create_countryC

Create country

Inputs: name (required), name_short (required), iso3166_alpha2 (required).

create_currencyC

Create a currency

Inputs: name (required), round_factor (required).

create_decline_quoteB

Decline a quote

Inputs: quote_id (required).

create_default_positionC

Create a default position

Inputs: document_id (required), kb_document_type (required), text, amount, +9 more.

create_delivery_from_orderC

Create delivery from order

Inputs: order_id (required), positions.

create_discount_positionC

Create a discount position

Inputs: document_id (required), kb_document_type (required), text, value, +1 more.

create_employeeD

Create employee

Inputs: iban, email, gender, address, +10 more.

create_expensC

Create new Expense

Inputs: amount (required), paid_on (required), currency_code (required), attachment_ids (required), +8 more.

create_expense_actionD

Execute Expense action

Inputs: id (required), action (required).

create_fictional_userC

Create a fictional user

Inputs: email (required), lastname (required), firstname (required), salutation_type (required), +1 more.

create_file_fileB

Create new file

Inputs: file (required).

create_invoiceD

Create invoice

Inputs: title, footer, header, user_id, +19 more.

create_invoice_from_orderB

Create invoice from order

Inputs: order_id (required), positions.

create_invoice_from_quoteB

Create invoice from quote

Inputs: quote_id (required), positions.

create_invoice_paymentD

Create payment

Inputs: value (required), invoice_id (required), date, bank_account_id, +1 more.

create_invoice_reminderC

Create reminder

Inputs: invoice_id (required).

create_itemD

Create item

Inputs: width, height, volume, weight, +28 more.

create_item_positionD

Create an item position

Inputs: document_id (required), kb_document_type (required), text, amount, +10 more.

create_manual_entryD

Create manual entry

Inputs: date (required), type (required), entries (required), reference_nr.

create_milestoneD

Create milestone

Inputs: name (required), project_id (required), comment, end_date, +1 more.

create_noteD

Create note

Inputs: subject (required), user_id (required), event_start (required), info, +4 more.

create_orderD

Create order

Inputs: title, footer, header, user_id, +19 more.

create_order_from_quoteC

Create order from quote

Inputs: quote_id (required), positions.

create_order_repetitionD

Edit a repetition

Inputs: order_id (required), end, start, repetition.

create_outgoing_paymentB

Create new Outgoing Payment

Inputs: amount (required), bill_id (required), payment_type (required), currency_code (required), +30 more.

create_pagebreak_positionC

Create a pagebreak position

Inputs: document_id (required), kb_document_type (required), pagebreak.

create_paymentD

Create a payment

Inputs: type (required), amount (required), currency (required), is_salary (required), +9 more.

create_projectC

Create project

Inputs: name (required), user_id (required), contact_id (required), pr_state_id (required), +10 more.

create_purchase_orderC

Create a purchase order

Inputs: id, mail, title, footer, +36 more.

create_quoteC

Create quote

Inputs: title, footer, header, user_id, +22 more.

create_reissue_quoteC

Reissue a quote

Inputs: quote_id (required).

create_salutationC

Create salutation

Inputs: name (required).

create_subpositionD

Create a sub position

Inputs: document_id (required), kb_document_type (required), text, show_pos_nr.

create_subtotal_positionC

Create a subtotal position

Inputs: document_id (required), kb_document_type (required), text.

create_taskD

Create task

Inputs: subject (required), user_id (required), info, entry_id, +11 more.

create_text_positionD

Create a text position

Inputs: document_id (required), kb_document_type (required), text, show_pos_nr.

create_timesheetD

Create timesheet

Inputs: user_id (required), tracking (required), allowable_bill (required), client_service_id (required), +9 more.

create_titleD

Create title

Inputs: name (required).

create_unitD

Create unit

Inputs: name (required).

create_work_packageC

Create work package

Inputs: name (required), project_id (required), comment, pr_milestone_id, +2 more.

delete_absenceB
DestructiveIdempotent

Deleting employee absence with given id

Inputs: absenceId (required), employeeId (required).

delete_additional_addressC
DestructiveIdempotent

Delete an additional address

Inputs: contact_id (required), additional_address_id (required).

delete_billB
DestructiveIdempotent

Delete Bill

Inputs: id (required).

delete_contactB
DestructiveIdempotent

Delete a contact

Inputs: contact_id (required).

delete_contact_groupC
DestructiveIdempotent

Delete a contact group

Inputs: contact_group_id (required).

delete_contact_relationB
DestructiveIdempotent

Delete a contact relation

Inputs: contact_relation_id (required).

delete_countryC
DestructiveIdempotent

Delete a country

Inputs: country_id (required).

delete_currencyB
DestructiveIdempotent

Delete a currency

Inputs: currency_id (required).

delete_default_positionB
DestructiveIdempotent

Delete a default position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_discount_positionC
DestructiveIdempotent

Delete a discount position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_expensB
DestructiveIdempotent

Delete Expense

Inputs: id (required).

delete_fictional_userB
DestructiveIdempotent

Delete a fictional user

Inputs: fictional_user_id (required).

delete_fileA
DestructiveIdempotent

Delete a existing file

Inputs: file_id (required).

delete_invoiceB
DestructiveIdempotent

Delete an invoice

Inputs: invoice_id (required).

delete_invoice_paymentC
DestructiveIdempotent

Delete a payment

Inputs: invoice_id (required), payment_id (required).

delete_invoice_reminderC
DestructiveIdempotent

Delete a reminder

Inputs: invoice_id (required), reminder_id (required).

delete_itemC
DestructiveIdempotent

Delete an item

Inputs: article_id (required).

delete_item_positionB
DestructiveIdempotent

Delete a item position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_manual_compound_entry_fileB
DestructiveIdempotent

Delete connection between file and manual compound entry

Inputs: file_id (required), manual_entry_id (required).

delete_manual_entryB
DestructiveIdempotent

Delete manual entry

Inputs: manual_entry_id (required).

delete_manual_entry_fileA
DestructiveIdempotent

Delete connection between file and manual entry line

Inputs: file_id (required), entry_id (required), manual_entry_id (required).

delete_milestoneB
DestructiveIdempotent

Delete a milestone

Inputs: project_id (required), milestone_id (required).

delete_noteC
DestructiveIdempotent

Delete a note

Inputs: note_id (required).

delete_orderB
DestructiveIdempotent

Delete an order

Inputs: order_id (required).

delete_order_repetitionD
DestructiveIdempotent

Delete a repetition

Inputs: order_id (required).

delete_outgoing_paymentC
DestructiveIdempotent

Delete Outgoing Payment

Inputs: id (required).

delete_pagebreak_positionA
DestructiveIdempotent

Delete a pagebreak position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_paymentC
DestructiveIdempotent

Delete a payment

Inputs: payment_id (required).

delete_projectB
DestructiveIdempotent

Delete a project

Inputs: project_id (required).

delete_purchase_orderB
DestructiveIdempotent

Delete a purchase order

Inputs: purchase_order_id (required).

delete_quoteB
DestructiveIdempotent

Delete a quote

Inputs: quote_id (required).

delete_salutationC
DestructiveIdempotent

Delete a salutation

Inputs: salutation_id (required).

delete_subpositionC
DestructiveIdempotent

Delete a sub position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_subtotal_positionC
DestructiveIdempotent

Delete a subtotal position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_taskC
DestructiveIdempotent

Delete a task

Inputs: task_id (required).

delete_taxB
DestructiveIdempotent

Delete a tax

Inputs: tax_id (required).

delete_text_positionC
DestructiveIdempotent

Delete a text position

Inputs: document_id (required), position_id (required), kb_document_type (required).

delete_timesheetC
DestructiveIdempotent

Delete a timesheet

Inputs: timesheet_id (required).

delete_titleC
DestructiveIdempotent

Delete a title

Inputs: title_id (required).

delete_unitC
DestructiveIdempotent

Delete a unit

Inputs: unit_id (required).

delete_work_packageB
DestructiveIdempotent

Delete a work package

Inputs: package_id (required), project_id (required).

download_fileC
Read-onlyIdempotent

Download file

Inputs: file_id (required).

get_absenceC
Read-onlyIdempotent

Retrieving absence for employee with given absence id

Inputs: absenceId (required), employeeId (required).

get_additional_addressC
Read-onlyIdempotent

Fetch an additional address

Inputs: contact_id (required), additional_address_id (required).

get_bank_accountA
Read-onlyIdempotent

Fetch a single bank account

Inputs: bank_account_id (required).

get_billC
Read-onlyIdempotent

Get Bill

Inputs: id (required).

get_business_yearC
Read-onlyIdempotent

Fetch a business year

Inputs: business_year_id (required).

get_calendar_yearB
Read-onlyIdempotent

Fetch a calendar year

Inputs: calendar_year_id (required).

get_commentC
Read-onlyIdempotent

Fetch a comment

Inputs: comment_id (required), document_id (required), kb_document_type (required).

get_company_profileC
Read-onlyIdempotent

Show company profile

Inputs: profile_id (required).

get_contactC
Read-onlyIdempotent

Fetch a contact

Inputs: contact_id (required), show_archived.

get_contact_groupC
Read-onlyIdempotent

Fetch a contact group

Inputs: contact_group_id (required).

get_contact_relationC
Read-onlyIdempotent

Fetch a contact relation

Inputs: contact_relation_id (required).

get_countryC
Read-onlyIdempotent

Fetch a country

Inputs: country_id (required).

get_currencyA
Read-onlyIdempotent

Fetch a currency

Inputs: currency_id (required).

get_default_positionC
Read-onlyIdempotent

Fetch a default position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_deliveryC
Read-onlyIdempotent

Fetch a delivery

Inputs: delivery_id (required).

get_discount_positionC
Read-onlyIdempotent

Fetch a discount position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_employee_on_dateC
Read-onlyIdempotent

Retrieve a single employee on a specific date

Inputs: date (required), employeeId (required).

get_expensD
Read-onlyIdempotent

Get Expense

Inputs: id (required).

get_fictional_userB
Read-onlyIdempotent

Fetch a fictional User

Inputs: fictional_user_id (required).

get_file_usageC
Read-onlyIdempotent

Show file usage

Inputs: file_id (required).

get_invoiceB
Read-onlyIdempotent

Fetch an invoice

Inputs: invoice_id (required).

get_invoice_paymentC
Read-onlyIdempotent

Fetch a payment

Inputs: invoice_id (required), payment_id (required).

get_invoice_pdfC
Read-onlyIdempotent

Show PDF

Inputs: invoice_id (required), logopaper.

get_invoice_reminderC
Read-onlyIdempotent

Fetch a reminder

Inputs: invoice_id (required), reminder_id (required).

get_invoice_reminder_pdfC
Read-onlyIdempotent

Show reminder PDF

Inputs: invoice_id (required), reminder_id (required), logopaper.

get_itemC
Read-onlyIdempotent

Fetch an item

Inputs: article_id (required).

get_item_positionC
Read-onlyIdempotent

Fetch an item position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_manual_compound_entry_fileC
Read-onlyIdempotent

Fetch file of manual compound entry

Inputs: file_id (required), manual_entry_id (required).

get_manual_entry_fileC
Read-onlyIdempotent

Fetch file of manual entry line

Inputs: file_id (required), entry_id (required), manual_entry_id (required).

get_milestoneB
Read-onlyIdempotent

Fetch a milestone

Inputs: project_id (required), milestone_id (required).

get_noteC
Read-onlyIdempotent

Fetch a note

Inputs: note_id (required).

get_orderC
Read-onlyIdempotent

Fetch an order

Inputs: order_id (required).

get_order_pdfD
Read-onlyIdempotent

Show PDF

Inputs: order_id (required), logopaper.

get_outgoing_paymentC
Read-onlyIdempotent

Get Outgoing Payment

Inputs: id (required).

get_pagebreak_positionB
Read-onlyIdempotent

Fetch a pagebreak position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_paymentC
Read-onlyIdempotent

Get a payment

Inputs: payment_id (required).

get_paystub_pdfB
Read-onlyIdempotent

Download paystub pdf for employee for given month

Inputs: year (required), month (required), employeeId (required).

get_pdf_for_employee_in_monthC
Read-onlyIdempotent

Retrieving pdf for employee for given month

Inputs: year (required), month (required), employeeId (required).

get_projectB
Read-onlyIdempotent

Fetch a project

Inputs: project_id (required).

get_purchase_orderA
Read-onlyIdempotent

Fetch a single purchase order

Inputs: purchase_order_id (required).

get_quoteC
Read-onlyIdempotent

Fetch a quote

Inputs: quote_id (required).

get_quote_pdfD
Read-onlyIdempotent

Show PDF

Inputs: quote_id (required), logopaper.

get_read_fileC
Read-onlyIdempotent

Get single file

Inputs: file_id (required).

get_salutationB
Read-onlyIdempotent

Fetch a salutation

Inputs: salutation_id (required).

get_subpositionC
Read-onlyIdempotent

Fetch a sub position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_subtotal_positionB
Read-onlyIdempotent

Fetch a subtotal position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_taskC
Read-onlyIdempotent

Fetch a task

Inputs: task_id (required).

get_taxC
Read-onlyIdempotent

Fetch a tax

Inputs: tax_id (required).

get_text_positionC
Read-onlyIdempotent

Fetch a text position

Inputs: document_id (required), position_id (required), kb_document_type (required).

get_timesheetB
Read-onlyIdempotent

Fetch a timesheet

Inputs: timesheet_id (required).

get_titleC
Read-onlyIdempotent

Fetch a title

Inputs: title_id (required).

get_unitA
Read-onlyIdempotent

Fetch a unit

Inputs: unit_id (required).

get_userC
Read-onlyIdempotent

Fetch a user

Inputs: user_id (required).

get_vat_periodB
Read-onlyIdempotent

Fetch a vat period

Inputs: vat_period_id (required).

get_work_packageC
Read-onlyIdempotent

Fetch a work package

Inputs: package_id (required), project_id (required).

issue_deliveryC

Issue a delivery

Inputs: delivery_id (required).

issue_invoiceC

Issue an invoice

Inputs: invoice_id (required).

issue_quoteC

Issue a quote

Inputs: quote_id (required).

list_account_groupsB
Read-onlyIdempotent

Fetch a list of account groups

Inputs: limit, offset.

list_accountsB
Read-onlyIdempotent

Fetch a list of accounts

Inputs: limit, offset.

list_additional_addressesB
Read-onlyIdempotent

Fetch a list of additional addresses

Inputs: contact_id (required), limit, offset, order_by.

list_all_paymentsB
Read-onlyIdempotent

Fetch a list of all payments

Inputs: page, per-page, filter-by.

list_bank_accountsB
Read-onlyIdempotent

Fetch a list of bank accounts

Inputs: limit, offset.

list_billsC
Read-onlyIdempotent

Get Bills

Inputs: page, sort, limit, order, +20 more.

list_business_activitiesB
Read-onlyIdempotent

Fetch a list of business activities

Inputs: limit, offset, order_by.

list_business_yearsA
Read-onlyIdempotent

Fetch a list of business years

Inputs: limit, offset.

list_calendar_yearsC
Read-onlyIdempotent

Fetch a list of calendar years

Inputs: limit, offset.

list_commentsC
Read-onlyIdempotent

Fetch a list of comments

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_communication_typesB
Read-onlyIdempotent

Fetch a list of communication types

Inputs: limit, offset, order_by.

list_company_profilesA
Read-onlyIdempotent

Fetch a list of company profiles

Inputs: no named parameters.

list_contact_groupsB
Read-onlyIdempotent

Fetch a list of contact groups

Inputs: limit, offset, order_by.

list_contact_relationsB
Read-onlyIdempotent

Fetch a list of contact relations

Inputs: limit, offset, order_by.

list_contactsB
Read-onlyIdempotent

Fetch a list of contacts

Inputs: limit, offset, order_by, show_archived.

list_contact_sectorsC
Read-onlyIdempotent

Fetch a list of contact sectors

Inputs: limit, offset, order_by.

list_countriesB
Read-onlyIdempotent

Fetch a list of countries

Inputs: limit, offset, order_by.

list_currenciesC
Read-onlyIdempotent

Fetch a list of currencies

Inputs: date, embed, limit, offset.

list_currencies_codesA
Read-onlyIdempotent

Fetch all possible currency codes

Inputs: no named parameters.

list_default_positionsB
Read-onlyIdempotent

Fetch a list of default positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_deliveriesB
Read-onlyIdempotent

Fetch a list of deliveries

Inputs: limit, offset, order_by.

list_discount_positionsB
Read-onlyIdempotent

Fetch a list of discount positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_document_settingsB
Read-onlyIdempotent

Fetch a list of document settings

Inputs: order_by.

list_document_templatesB
Read-onlyIdempotent

List document templates

Inputs: no named parameters.

list_employee_absence_in_yearsA
Read-onlyIdempotent

Retrieving absences of employee for given year

Inputs: employeeId (required), businessYear (required).

list_employeesA
Read-onlyIdempotent

Retrieves all active employees

Inputs: no named parameters.

list_exchange_rates_for_currenciesB
Read-onlyIdempotent

Fetch exchange rates for currencies

Inputs: currency_id (required), date.

list_expense_document_numbersB
Read-onlyIdempotent

Validate whether document number is available or not

Inputs: document_no (required).

list_expensesD
Read-onlyIdempotent

Get Expenses

Inputs: page, sort, limit, order, +14 more.

list_fictional_usersB
Read-onlyIdempotent

Fetch a list of fictional users

Inputs: limit, offset.

list_invoice_paymentsC
Read-onlyIdempotent

Fetch a list of payments

Inputs: invoice_id (required), limit, offset.

list_invoice_remindersC
Read-onlyIdempotent

Fetch a list of reminders

Inputs: invoice_id (required).

list_invoicesB
Read-onlyIdempotent

Fetch a list of invoices

Inputs: limit, offset, order_by.

list_item_positionsC
Read-onlyIdempotent

Fetch a list of item positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_itemsB
Read-onlyIdempotent

Fetch a list of items

Inputs: limit, offset, order_by.

list_journal_entriesD
Read-onlyIdempotent

Journal

Inputs: to, from, limit, offset, +1 more.

list_languagesB
Read-onlyIdempotent

Fetch a list of languages

Inputs: limit, offset, order_by.

list_manual_compound_entry_filesB
Read-onlyIdempotent

Fetch files of manual compound entry

Inputs: manual_entry_id (required), limit, offset.

list_manual_entriesC
Read-onlyIdempotent

Fetch a list of manual entries

Inputs: limit, offset.

list_manual_entry_filesC
Read-onlyIdempotent

Fetch files of manual entry line

Inputs: entry_id (required), manual_entry_id (required), limit, offset.

list_mesA
Read-onlyIdempotent

Fetch the authenticated user

Inputs: no named parameters.

list_milestonesB
Read-onlyIdempotent

Fetch a list of milestones

Inputs: project_id (required), limit, offset.

list_next_reference_numbersC
Read-onlyIdempotent

Get next reference number

Inputs: no named parameters.

list_notesC
Read-onlyIdempotent

Fetch a list of notes

Inputs: limit, offset.

list_order_repetitionsC
Read-onlyIdempotent

Show repetition

Inputs: order_id (required).

list_ordersB
Read-onlyIdempotent

Fetch a list of orders

Inputs: limit, offset, order_by.

list_outgoing_paymentsC
Read-onlyIdempotent

Retrieve Outgoing Payments

Inputs: bill_id (required), page, sort, limit, +1 more.

list_pagebreak_positionsA
Read-onlyIdempotent

Fetch a list of pagebreak positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_payment_typesC
Read-onlyIdempotent

Fetch a list of payment types

Inputs: limit, offset, order_by.

list_permissionsA
Read-onlyIdempotent

Get access information of logged in user

Inputs: no named parameters.

list_preview_filesC
Read-onlyIdempotent

Get file preview

Inputs: file_id (required).

list_projectsB
Read-onlyIdempotent

Fetch a list of projects

Inputs: limit, offset, order_by.

list_project_statusC
Read-onlyIdempotent

Project status

Inputs: no named parameters.

list_project_typesC
Read-onlyIdempotent

Project types

Inputs: order_by.

list_purchase_document_numbersC
Read-onlyIdempotent

Validate whether document number is available or not

Inputs: document_no (required).

list_purchase_ordersC
Read-onlyIdempotent

Fetch a list of purchase orders

Inputs: limit, offset, order_by.

list_quotesB
Read-onlyIdempotent

Fetch a list of quotes

Inputs: limit, offset, order_by.

list_read_filesC
Read-onlyIdempotent

Fetch a list of files

Inputs: offset, order_by, archived_state.

list_salutationsB
Read-onlyIdempotent

Fetch a list of salutations

Inputs: limit, offset.

list_stock_areasB
Read-onlyIdempotent

Fetch a list of stock areas

Inputs: limit, offset, order_by.

list_stock_locationsB
Read-onlyIdempotent

Fetch a list of stock locations

Inputs: limit, offset, order_by.

list_subposition_positionsC
Read-onlyIdempotent

Fetch a list of sub positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_subtotal_positionsB
Read-onlyIdempotent

Fetch a list of subtotal positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_task_prioritiesC
Read-onlyIdempotent

Task priorities

Inputs: limit, offset, order_by.

list_tasksC
Read-onlyIdempotent

Fetch a list of tasks

Inputs: limit, offset, order_by.

list_task_statusD
Read-onlyIdempotent

Task status

Inputs: limit, offset, order_by.

list_taxesB
Read-onlyIdempotent

Fetch a list of taxes

Inputs: date, limit, scope, types, +1 more.

list_text_positionsC
Read-onlyIdempotent

Fetch a list of text positions

Inputs: document_id (required), kb_document_type (required), limit, offset.

list_timesheetsC
Read-onlyIdempotent

Fetch a list of timesheets

Inputs: limit, offset, order_by.

list_time_sheet_statusC
Read-onlyIdempotent

Timesheet status

Inputs: limit, offset, order_by.

list_titlesC
Read-onlyIdempotent

Fetch a list of titles

Inputs: limit, offset, order_by.

list_unitsB
Read-onlyIdempotent

Fetch a list of units

Inputs: limit, offset.

list_usersB
Read-onlyIdempotent

Fetch a list of users

Inputs: limit, offset.

list_vat_periodsC
Read-onlyIdempotent

Fetch a list of vat periods

Inputs: limit, offset.

list_work_packagesC
Read-onlyIdempotent

Fetch a list of work packages

Inputs: project_id (required), limit, offset.

mark_as_sent_invoiceC

Mark invoice as sent

Inputs: invoice_id (required).

mark_as_sent_invoice_reminderC

Mark reminder as sent

Inputs: invoice_id (required), reminder_id (required).

mark_as_sent_quoteB

Mark quote as sent

Inputs: quote_id (required).

mark_as_unsent_invoice_reminderC

Mark reminder as unsent

Inputs: invoice_id (required), reminder_id (required).

restore_contactB

Restore a contact

Inputs: contact_id (required).

revert_issue_invoiceA

Sets issued invoice to draft

Inputs: invoice_id (required).

revert_issue_quoteD

Revert issue a quote

Inputs: quote_id (required).

search_accountsC

Search Accounts

Inputs: body (required), limit, offset.

search_additional_addressesD

Search additional addresses

Inputs: body (required), contact_id (required), limit, offset, +1 more.

search_business_activitiesC

Search business activities

Inputs: body (required), limit, offset, order_by.

search_calendar_yearsD

Search calendar years

Inputs: body (required), limit, offset.

search_communication_typesC

Search communication types

Inputs: body (required), limit, offset, order_by.

search_contact_groupsC

Search contact groups

Inputs: body (required), limit, offset, order_by.

search_contact_relationsC

Search contact relations

Inputs: body (required), limit, offset, order_by.

search_contactsC

Search contacts

Inputs: body (required), limit, offset, order_by, +1 more.

search_contact_sectorsC

Search contact sectors

Inputs: body (required), limit, offset, order_by.

search_countriesC

Search countries

Inputs: body (required), limit, offset, order_by.

search_filesC

Search files

Inputs: body (required), limit, offset, archived_state.

search_invoicesC

Search invoices

Inputs: body (required), limit, offset, order_by.

search_itemsC

Search items

Inputs: body (required), limit, offset, order_by.

search_languagesC

Search languages

Inputs: body (required), limit, offset, order_by.

search_notesC

Search notes

Inputs: body (required), limit, offset.

search_ordersD

Search orders

Inputs: body (required), limit, offset, order_by.

search_payment_typesC

Search payment types

Inputs: body (required), limit, offset, order_by.

search_projectsD

Search projects

Inputs: body (required), limit, offset, order_by.

search_quotesC

Search quotes

Inputs: body (required), limit, offset, order_by.

search_remindersC

Search invoice reminders

Inputs: body (required), invoice_id (required).

search_salutationsC

Search salutations

Inputs: body (required), limit, offset.

search_stock_areasC

Search stock areas

Inputs: body (required), limit, offset, order_by.

search_stock_locationsD

Search stock locations

Inputs: body (required), limit, offset, order_by.

search_tasksD

Search tasks

Inputs: body (required), limit, offset, order_by.

search_timesheetsC

Search timesheets

Inputs: body (required), limit, offset, order_by.

search_titlesC

Search titles

Inputs: body (required), limit, offset, order_by.

search_unitsD

Search units

Inputs: body (required), limit, offset.

send_invoiceC

Send an invoice

Inputs: message (required), subject (required), invoice_id (required), recipient_email (required), +2 more.

send_invoice_reminderC

Send a reminder

Inputs: message (required), subject (required), invoice_id (required), reminder_id (required), +1 more.

send_quoteC

Send a quote

Inputs: message (required), subject (required), quote_id (required), recipient_email (required), +2 more.

unarchive_projectB

Unarchive a project

Inputs: project_id (required).

update_absenceC
Idempotent

Updating existing absence

Inputs: reason (required), end_date (required), half_day (required), absenceId (required), +5 more.

update_additional_addressC

Edit an additional address

Inputs: contact_id (required), additional_address_id (required), city, name, +8 more.

update_billD
Idempotent

Update Bill

Inputs: id (required), address (required), due_date (required), item_net (required), +17 more.

update_bill_bookingC
Idempotent

Update Bill status

Inputs: id (required), status (required).

update_contactC

Edit a contact

Inputs: name_1 (required), user_id (required), owner_id (required), contact_id (required), +25 more.

update_contact_groupC

Edit a contact group

Inputs: name (required), contact_group_id (required).

update_contact_relationC

Edit a contact relation

Inputs: contact_id (required), contact_sub_id (required), contact_relation_id (required), description.

update_countryC

Edit a country

Inputs: name (required), country_id (required), name_short (required), iso3166_alpha2 (required).

update_currencyC

Update a currency

Inputs: currency_id (required), round_factor.

update_default_positionC

Edit a default position

Inputs: document_id (required), position_id (required), kb_document_type (required), text, +10 more.

update_discount_positionC

Edit a discount position

Inputs: document_id (required), position_id (required), kb_document_type (required), text, +2 more.

update_employeeD

Update employee

Inputs: employeeId (required), iban, email, gender, +11 more.

update_expensD
Idempotent

Update Expense

Inputs: id (required), amount (required), paid_on (required), currency_code (required), +10 more.

update_expense_bookingB
Idempotent

Update Expense status

Inputs: id (required), status (required).

update_fictional_userC

Update a fictional User

Inputs: email (required), lastname (required), firstname (required), salutation_type (required), +2 more.

update_fileC

Update existing file

Inputs: file_id (required), name, is_archived, source_type.

update_invoiceC

Edit an invoice

Inputs: invoice_id (required), title, footer, header, +19 more.

update_itemC

Edit an item

Inputs: article_id (required), width, height, volume, +28 more.

update_item_positionC

Edit an item position

Inputs: document_id (required), position_id (required), kb_document_type (required), text, +11 more.

update_manual_entryD
Idempotent

Update manual entry

Inputs: date (required), type (required), entries (required), manual_entry_id (required), +2 more.

update_milestoneC

Edit a milestone

Inputs: name (required), project_id (required), milestone_id (required), comment, +2 more.

update_noteC

Edit a note

Inputs: note_id (required), subject (required), user_id (required), event_start (required), +5 more.

update_orderC

Edit an order

Inputs: order_id (required), title, footer, header, +19 more.

update_outgoing_paymentC
Idempotent

Edit Outgoing Payment

Inputs: amount (required), payment_id (required), execution_date (required), is_salary_payment (required), +10 more.

update_pagebreak_positionC

Edit a pagebreak position

Inputs: document_id (required), position_id (required), kb_document_type (required), pagebreak.

update_paymentC
Idempotent

Update a payment

Inputs: payment_id (required), amount, message, currency, +7 more.

update_projectC

Edit a project

Inputs: name (required), user_id (required), contact_id (required), project_id (required), +11 more.

update_purchase_orderC
Idempotent

Update a single purchase order

Inputs: purchase_order_id (required), id, mail, title, +36 more.

update_quoteC

Edit a quote

Inputs: quote_id (required), title, footer, header, +22 more.

update_salutationC

Edit a salutation

Inputs: name (required), salutation_id (required).

update_subpositionC

Edit a sub position

Inputs: document_id (required), position_id (required), kb_document_type (required), text, +1 more.

update_subtotal_positionC

Edit a subtotal position

Inputs: document_id (required), position_id (required), kb_document_type (required), text.

update_taskC

Edit a task

Inputs: subject (required), task_id (required), user_id (required), info, +12 more.

update_text_positionC

Edit a text position

Inputs: document_id (required), position_id (required), kb_document_type (required), text, +1 more.

update_timesheetD

Edit a timesheet

Inputs: user_id (required), tracking (required), timesheet_id (required), allowable_bill (required), +10 more.

update_titleC

Edit a title

Inputs: name (required), title_id (required).

update_unitC

Edit a unit

Inputs: name (required), unit_id (required).

update_work_packageC

Edit a work package

Inputs: name (required), package_id (required), project_id (required), comment, +3 more.

upload_manual_compound_entry_file_fileC

Add file to manual compound entry

Inputs: manual_entry_id (required), fileName.

upload_manual_entry_file_fileC

Add file to manual entry line

Inputs: entry_id (required), manual_entry_id (required), fileName.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 310 tools

    Disambiguation2/5

    Multiple tools have overlapping purposes or unclear boundaries, such as the various position types (item_position, discount_position, pagebreak_position, etc.) and the duplicate paystub PDF tools (get_paystub_pdf vs get_pdf_for_employee_in_month). The 'expens' vs 'expense' naming further adds confusion.

    Naming Consistency2/5

    While many tools follow a verb_noun pattern, there are significant deviations like create_expens, create_file_file, upload_manual_compound_entry_file_file, list_mes, and inconsistent use of 'list' vs 'search'. This mixed convention hurts predictability.

    Tool Count1/5

    With 310 tools, the server is far too large for a coherent MCP interface. Even for a broad ERP system, this is excessive and likely overwhelms agents, making selection difficult.

    Completeness3/5

    The tool set covers a wide range of business domains (contacts, invoices, orders, projects, tasks, etc.), but there are gaps (e.g., no update for company_profile, no delete for business_activity) and redundancies that indicate incomplete or uneven coverage.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Complete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 221 tools for invoices, contacts, projects & more. Created by Lukas Hertig.
      42
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      MCP server for smallinvoice.ch — Swiss SME invoicing and accounting with 146 tools and OAuth2 BYOC authentication.
      100
      9 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A remote MCP server for the Moxie Public API, deployable to Cloudflare Workers. Exposes all 29 documented Moxie endpoints as MCP tools for managing clients, contacts, projects, tasks, invoices, payments, and more.
      -
    • A
      license
      A
      quality
      D
      maintenance
      A standalone MCP server for the bexio REST API, enabling interaction with bexio resources like contacts, invoices, and projects through natural language from any MCP client.
      21
      14 npm
      MIT