@aiwerk/mcp-server-bexio
This server provides comprehensive access to the bexio Swiss business software API, with 310+ tools covering CRM, invoicing, accounting, payroll, and more.
Contacts & CRM
Full CRUD, search, restore, and bulk create for contacts (persons and companies)
Manage contact groups, relations, sectors, and additional addresses
Sales Documents
Quotes, orders, invoices: create, update, delete, send, cancel, issue
Manage document positions (default and discount) and comments
Manage deliveries (list, get, issue)
Bills & Expenses
Full CRUD for bills and expenses, plus duplicate, booking status, and purchase number validation
Manage bill payments and expense attachments
Banking & Accounting
List and retrieve bank accounts
Accounts, account groups, business/calendar years, currencies, exchange rates
Payroll & HR
Employees: CRUD
Absences: CRUD, list by year
Download paystub and other PDF reports
Reference Data & Settings
Countries, languages, titles, salutations, communication types
Business activities, company profile, document templates
Contact sectors, units
Safety & Configuration
Dry-run mode for safe write testing
Pre-write snapshots for automatic backup before changes
Rate limit handling with retries
Domain filtering to restrict active tools to specific areas (e.g., Contacts, Invoices)
Supports OAuth 2.0 and personal access tokens
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., "@@aiwerk/mcp-server-bexio Create a new invoice for the Baumann project."
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.
@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 NotesWhy 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-bexioRequires 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-bexioClaude 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=1Every 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 |
| required | Personal access token |
|
| Override the host, applies to all API versions |
|
| Per request timeout |
| off |
|
| off |
|
| off |
|
|
| Where snapshots are written |
|
| Longest wait before failing on a rate limit |
| all | Comma separated domain filter, for example |
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_contactCollection 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_idas required, yet bexio rejects a position without one. Fetch a valid id withlist_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
addressis readable but not writable. Reading a contact returns a combinedaddress("Alte Jonastrasse 24") next to the split fields, but a write only acceptsstreet_name,house_number,postcodeandcity. Reading a contact and sending it straight back is rejected with 422.contact_type_idis1for a company and2for a person.
Testing
npm test # unit tests
npm run smoke # read only, against a live accountThe 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.mjsPoint 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 buildLicence
MIT, see LICENSE.
Built by AIWerk. Not affiliated with bexio AG.
Available Tools
310 toolsarchive_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_absenceBDestructiveIdempotent
Deleting employee absence with given id
Inputs: absenceId (required), employeeId (required).
delete_additional_addressCDestructiveIdempotent
Delete an additional address
Inputs: contact_id (required), additional_address_id (required).
delete_billBDestructiveIdempotent
Delete Bill
Inputs: id (required).
delete_contactBDestructiveIdempotent
Delete a contact
Inputs: contact_id (required).
delete_contact_groupCDestructiveIdempotent
Delete a contact group
Inputs: contact_group_id (required).
delete_contact_relationBDestructiveIdempotent
Delete a contact relation
Inputs: contact_relation_id (required).
delete_countryCDestructiveIdempotent
Delete a country
Inputs: country_id (required).
delete_currencyBDestructiveIdempotent
Delete a currency
Inputs: currency_id (required).
delete_default_positionBDestructiveIdempotent
Delete a default position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_discount_positionCDestructiveIdempotent
Delete a discount position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_expensBDestructiveIdempotent
Delete Expense
Inputs: id (required).
delete_fictional_userBDestructiveIdempotent
Delete a fictional user
Inputs: fictional_user_id (required).
delete_fileADestructiveIdempotent
Delete a existing file
Inputs: file_id (required).
delete_invoiceBDestructiveIdempotent
Delete an invoice
Inputs: invoice_id (required).
delete_invoice_paymentCDestructiveIdempotent
Delete a payment
Inputs: invoice_id (required), payment_id (required).
delete_invoice_reminderCDestructiveIdempotent
Delete a reminder
Inputs: invoice_id (required), reminder_id (required).
delete_itemCDestructiveIdempotent
Delete an item
Inputs: article_id (required).
delete_item_positionBDestructiveIdempotent
Delete a item position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_manual_compound_entry_fileBDestructiveIdempotent
Delete connection between file and manual compound entry
Inputs: file_id (required), manual_entry_id (required).
delete_manual_entryBDestructiveIdempotent
Delete manual entry
Inputs: manual_entry_id (required).
delete_manual_entry_fileADestructiveIdempotent
Delete connection between file and manual entry line
Inputs: file_id (required), entry_id (required), manual_entry_id (required).
delete_milestoneBDestructiveIdempotent
Delete a milestone
Inputs: project_id (required), milestone_id (required).
delete_noteCDestructiveIdempotent
Delete a note
Inputs: note_id (required).
delete_orderBDestructiveIdempotent
Delete an order
Inputs: order_id (required).
delete_order_repetitionDDestructiveIdempotent
Delete a repetition
Inputs: order_id (required).
delete_outgoing_paymentCDestructiveIdempotent
Delete Outgoing Payment
Inputs: id (required).
delete_pagebreak_positionADestructiveIdempotent
Delete a pagebreak position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_paymentCDestructiveIdempotent
Delete a payment
Inputs: payment_id (required).
delete_projectBDestructiveIdempotent
Delete a project
Inputs: project_id (required).
delete_purchase_orderBDestructiveIdempotent
Delete a purchase order
Inputs: purchase_order_id (required).
delete_quoteBDestructiveIdempotent
Delete a quote
Inputs: quote_id (required).
delete_salutationCDestructiveIdempotent
Delete a salutation
Inputs: salutation_id (required).
delete_subpositionCDestructiveIdempotent
Delete a sub position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_subtotal_positionCDestructiveIdempotent
Delete a subtotal position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_taskCDestructiveIdempotent
Delete a task
Inputs: task_id (required).
delete_taxBDestructiveIdempotent
Delete a tax
Inputs: tax_id (required).
delete_text_positionCDestructiveIdempotent
Delete a text position
Inputs: document_id (required), position_id (required), kb_document_type (required).
delete_timesheetCDestructiveIdempotent
Delete a timesheet
Inputs: timesheet_id (required).
delete_titleCDestructiveIdempotent
Delete a title
Inputs: title_id (required).
delete_unitCDestructiveIdempotent
Delete a unit
Inputs: unit_id (required).
delete_work_packageBDestructiveIdempotent
Delete a work package
Inputs: package_id (required), project_id (required).
download_fileCRead-onlyIdempotent
Download file
Inputs: file_id (required).
get_absenceCRead-onlyIdempotent
Retrieving absence for employee with given absence id
Inputs: absenceId (required), employeeId (required).
get_additional_addressCRead-onlyIdempotent
Fetch an additional address
Inputs: contact_id (required), additional_address_id (required).
get_bank_accountARead-onlyIdempotent
Fetch a single bank account
Inputs: bank_account_id (required).
get_billCRead-onlyIdempotent
Get Bill
Inputs: id (required).
get_business_yearCRead-onlyIdempotent
Fetch a business year
Inputs: business_year_id (required).
get_calendar_yearBRead-onlyIdempotent
Fetch a calendar year
Inputs: calendar_year_id (required).
get_commentCRead-onlyIdempotent
Fetch a comment
Inputs: comment_id (required), document_id (required), kb_document_type (required).
get_company_profileCRead-onlyIdempotent
Show company profile
Inputs: profile_id (required).
get_contactCRead-onlyIdempotent
Fetch a contact
Inputs: contact_id (required), show_archived.
get_contact_groupCRead-onlyIdempotent
Fetch a contact group
Inputs: contact_group_id (required).
get_contact_relationCRead-onlyIdempotent
Fetch a contact relation
Inputs: contact_relation_id (required).
get_countryCRead-onlyIdempotent
Fetch a country
Inputs: country_id (required).
get_currencyARead-onlyIdempotent
Fetch a currency
Inputs: currency_id (required).
get_default_positionCRead-onlyIdempotent
Fetch a default position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_deliveryCRead-onlyIdempotent
Fetch a delivery
Inputs: delivery_id (required).
get_discount_positionCRead-onlyIdempotent
Fetch a discount position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_employee_on_dateCRead-onlyIdempotent
Retrieve a single employee on a specific date
Inputs: date (required), employeeId (required).
get_expensDRead-onlyIdempotent
Get Expense
Inputs: id (required).
get_fictional_userBRead-onlyIdempotent
Fetch a fictional User
Inputs: fictional_user_id (required).
get_file_usageCRead-onlyIdempotent
Show file usage
Inputs: file_id (required).
get_invoiceBRead-onlyIdempotent
Fetch an invoice
Inputs: invoice_id (required).
get_invoice_paymentCRead-onlyIdempotent
Fetch a payment
Inputs: invoice_id (required), payment_id (required).
get_invoice_pdfCRead-onlyIdempotent
Show PDF
Inputs: invoice_id (required), logopaper.
get_invoice_reminderCRead-onlyIdempotent
Fetch a reminder
Inputs: invoice_id (required), reminder_id (required).
get_invoice_reminder_pdfCRead-onlyIdempotent
Show reminder PDF
Inputs: invoice_id (required), reminder_id (required), logopaper.
get_itemCRead-onlyIdempotent
Fetch an item
Inputs: article_id (required).
get_item_positionCRead-onlyIdempotent
Fetch an item position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_manual_compound_entry_fileCRead-onlyIdempotent
Fetch file of manual compound entry
Inputs: file_id (required), manual_entry_id (required).
get_manual_entry_fileCRead-onlyIdempotent
Fetch file of manual entry line
Inputs: file_id (required), entry_id (required), manual_entry_id (required).
get_milestoneBRead-onlyIdempotent
Fetch a milestone
Inputs: project_id (required), milestone_id (required).
get_noteCRead-onlyIdempotent
Fetch a note
Inputs: note_id (required).
get_orderCRead-onlyIdempotent
Fetch an order
Inputs: order_id (required).
get_order_pdfDRead-onlyIdempotent
Show PDF
Inputs: order_id (required), logopaper.
get_outgoing_paymentCRead-onlyIdempotent
Get Outgoing Payment
Inputs: id (required).
get_pagebreak_positionBRead-onlyIdempotent
Fetch a pagebreak position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_paymentCRead-onlyIdempotent
Get a payment
Inputs: payment_id (required).
get_paystub_pdfBRead-onlyIdempotent
Download paystub pdf for employee for given month
Inputs: year (required), month (required), employeeId (required).
get_pdf_for_employee_in_monthCRead-onlyIdempotent
Retrieving pdf for employee for given month
Inputs: year (required), month (required), employeeId (required).
get_projectBRead-onlyIdempotent
Fetch a project
Inputs: project_id (required).
get_purchase_orderARead-onlyIdempotent
Fetch a single purchase order
Inputs: purchase_order_id (required).
get_quoteCRead-onlyIdempotent
Fetch a quote
Inputs: quote_id (required).
get_quote_pdfDRead-onlyIdempotent
Show PDF
Inputs: quote_id (required), logopaper.
get_read_fileCRead-onlyIdempotent
Get single file
Inputs: file_id (required).
get_salutationBRead-onlyIdempotent
Fetch a salutation
Inputs: salutation_id (required).
get_subpositionCRead-onlyIdempotent
Fetch a sub position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_subtotal_positionBRead-onlyIdempotent
Fetch a subtotal position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_taskCRead-onlyIdempotent
Fetch a task
Inputs: task_id (required).
get_taxCRead-onlyIdempotent
Fetch a tax
Inputs: tax_id (required).
get_text_positionCRead-onlyIdempotent
Fetch a text position
Inputs: document_id (required), position_id (required), kb_document_type (required).
get_timesheetBRead-onlyIdempotent
Fetch a timesheet
Inputs: timesheet_id (required).
get_titleCRead-onlyIdempotent
Fetch a title
Inputs: title_id (required).
get_unitARead-onlyIdempotent
Fetch a unit
Inputs: unit_id (required).
get_userCRead-onlyIdempotent
Fetch a user
Inputs: user_id (required).
get_vat_periodBRead-onlyIdempotent
Fetch a vat period
Inputs: vat_period_id (required).
get_work_packageCRead-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_groupsBRead-onlyIdempotent
Fetch a list of account groups
Inputs: limit, offset.
list_accountsBRead-onlyIdempotent
Fetch a list of accounts
Inputs: limit, offset.
list_additional_addressesBRead-onlyIdempotent
Fetch a list of additional addresses
Inputs: contact_id (required), limit, offset, order_by.
list_all_paymentsBRead-onlyIdempotent
Fetch a list of all payments
Inputs: page, per-page, filter-by.
list_bank_accountsBRead-onlyIdempotent
Fetch a list of bank accounts
Inputs: limit, offset.
list_billsCRead-onlyIdempotent
Get Bills
Inputs: page, sort, limit, order, +20 more.
list_business_activitiesBRead-onlyIdempotent
Fetch a list of business activities
Inputs: limit, offset, order_by.
list_business_yearsARead-onlyIdempotent
Fetch a list of business years
Inputs: limit, offset.
list_calendar_yearsCRead-onlyIdempotent
Fetch a list of calendar years
Inputs: limit, offset.
list_commentsCRead-onlyIdempotent
Fetch a list of comments
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_communication_typesBRead-onlyIdempotent
Fetch a list of communication types
Inputs: limit, offset, order_by.
list_company_profilesARead-onlyIdempotent
Fetch a list of company profiles
Inputs: no named parameters.
list_contact_groupsBRead-onlyIdempotent
Fetch a list of contact groups
Inputs: limit, offset, order_by.
list_contact_relationsBRead-onlyIdempotent
Fetch a list of contact relations
Inputs: limit, offset, order_by.
list_contactsBRead-onlyIdempotent
Fetch a list of contacts
Inputs: limit, offset, order_by, show_archived.
list_contact_sectorsCRead-onlyIdempotent
Fetch a list of contact sectors
Inputs: limit, offset, order_by.
list_countriesBRead-onlyIdempotent
Fetch a list of countries
Inputs: limit, offset, order_by.
list_currenciesCRead-onlyIdempotent
Fetch a list of currencies
Inputs: date, embed, limit, offset.
list_currencies_codesARead-onlyIdempotent
Fetch all possible currency codes
Inputs: no named parameters.
list_default_positionsBRead-onlyIdempotent
Fetch a list of default positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_deliveriesBRead-onlyIdempotent
Fetch a list of deliveries
Inputs: limit, offset, order_by.
list_discount_positionsBRead-onlyIdempotent
Fetch a list of discount positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_document_settingsBRead-onlyIdempotent
Fetch a list of document settings
Inputs: order_by.
list_document_templatesBRead-onlyIdempotent
List document templates
Inputs: no named parameters.
list_employee_absence_in_yearsARead-onlyIdempotent
Retrieving absences of employee for given year
Inputs: employeeId (required), businessYear (required).
list_employeesARead-onlyIdempotent
Retrieves all active employees
Inputs: no named parameters.
list_exchange_rates_for_currenciesBRead-onlyIdempotent
Fetch exchange rates for currencies
Inputs: currency_id (required), date.
list_expense_document_numbersBRead-onlyIdempotent
Validate whether document number is available or not
Inputs: document_no (required).
list_expensesDRead-onlyIdempotent
Get Expenses
Inputs: page, sort, limit, order, +14 more.
list_fictional_usersBRead-onlyIdempotent
Fetch a list of fictional users
Inputs: limit, offset.
list_invoice_paymentsCRead-onlyIdempotent
Fetch a list of payments
Inputs: invoice_id (required), limit, offset.
list_invoice_remindersCRead-onlyIdempotent
Fetch a list of reminders
Inputs: invoice_id (required).
list_invoicesBRead-onlyIdempotent
Fetch a list of invoices
Inputs: limit, offset, order_by.
list_item_positionsCRead-onlyIdempotent
Fetch a list of item positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_itemsBRead-onlyIdempotent
Fetch a list of items
Inputs: limit, offset, order_by.
list_journal_entriesDRead-onlyIdempotent
Journal
Inputs: to, from, limit, offset, +1 more.
list_languagesBRead-onlyIdempotent
Fetch a list of languages
Inputs: limit, offset, order_by.
list_manual_compound_entry_filesBRead-onlyIdempotent
Fetch files of manual compound entry
Inputs: manual_entry_id (required), limit, offset.
list_manual_entriesCRead-onlyIdempotent
Fetch a list of manual entries
Inputs: limit, offset.
list_manual_entry_filesCRead-onlyIdempotent
Fetch files of manual entry line
Inputs: entry_id (required), manual_entry_id (required), limit, offset.
list_mesARead-onlyIdempotent
Fetch the authenticated user
Inputs: no named parameters.
list_milestonesBRead-onlyIdempotent
Fetch a list of milestones
Inputs: project_id (required), limit, offset.
list_next_reference_numbersCRead-onlyIdempotent
Get next reference number
Inputs: no named parameters.
list_notesCRead-onlyIdempotent
Fetch a list of notes
Inputs: limit, offset.
list_order_repetitionsCRead-onlyIdempotent
Show repetition
Inputs: order_id (required).
list_ordersBRead-onlyIdempotent
Fetch a list of orders
Inputs: limit, offset, order_by.
list_outgoing_paymentsCRead-onlyIdempotent
Retrieve Outgoing Payments
Inputs: bill_id (required), page, sort, limit, +1 more.
list_pagebreak_positionsARead-onlyIdempotent
Fetch a list of pagebreak positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_payment_typesCRead-onlyIdempotent
Fetch a list of payment types
Inputs: limit, offset, order_by.
list_permissionsARead-onlyIdempotent
Get access information of logged in user
Inputs: no named parameters.
list_preview_filesCRead-onlyIdempotent
Get file preview
Inputs: file_id (required).
list_projectsBRead-onlyIdempotent
Fetch a list of projects
Inputs: limit, offset, order_by.
list_project_statusCRead-onlyIdempotent
Project status
Inputs: no named parameters.
list_project_typesCRead-onlyIdempotent
Project types
Inputs: order_by.
list_purchase_document_numbersCRead-onlyIdempotent
Validate whether document number is available or not
Inputs: document_no (required).
list_purchase_ordersCRead-onlyIdempotent
Fetch a list of purchase orders
Inputs: limit, offset, order_by.
list_quotesBRead-onlyIdempotent
Fetch a list of quotes
Inputs: limit, offset, order_by.
list_read_filesCRead-onlyIdempotent
Fetch a list of files
Inputs: offset, order_by, archived_state.
list_salutationsBRead-onlyIdempotent
Fetch a list of salutations
Inputs: limit, offset.
list_stock_areasBRead-onlyIdempotent
Fetch a list of stock areas
Inputs: limit, offset, order_by.
list_stock_locationsBRead-onlyIdempotent
Fetch a list of stock locations
Inputs: limit, offset, order_by.
list_subposition_positionsCRead-onlyIdempotent
Fetch a list of sub positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_subtotal_positionsBRead-onlyIdempotent
Fetch a list of subtotal positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_task_prioritiesCRead-onlyIdempotent
Task priorities
Inputs: limit, offset, order_by.
list_tasksCRead-onlyIdempotent
Fetch a list of tasks
Inputs: limit, offset, order_by.
list_task_statusDRead-onlyIdempotent
Task status
Inputs: limit, offset, order_by.
list_taxesBRead-onlyIdempotent
Fetch a list of taxes
Inputs: date, limit, scope, types, +1 more.
list_text_positionsCRead-onlyIdempotent
Fetch a list of text positions
Inputs: document_id (required), kb_document_type (required), limit, offset.
list_timesheetsCRead-onlyIdempotent
Fetch a list of timesheets
Inputs: limit, offset, order_by.
list_time_sheet_statusCRead-onlyIdempotent
Timesheet status
Inputs: limit, offset, order_by.
list_titlesCRead-onlyIdempotent
Fetch a list of titles
Inputs: limit, offset, order_by.
list_unitsBRead-onlyIdempotent
Fetch a list of units
Inputs: limit, offset.
list_usersBRead-onlyIdempotent
Fetch a list of users
Inputs: limit, offset.
list_vat_periodsCRead-onlyIdempotent
Fetch a list of vat periods
Inputs: limit, offset.
list_work_packagesCRead-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_absenceCIdempotent
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_billDIdempotent
Update Bill
Inputs: id (required), address (required), due_date (required), item_net (required), +17 more.
update_bill_bookingCIdempotent
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_expensDIdempotent
Update Expense
Inputs: id (required), amount (required), paid_on (required), currency_code (required), +10 more.
update_expense_bookingBIdempotent
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_entryDIdempotent
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_paymentCIdempotent
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_paymentCIdempotent
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_orderCIdempotent
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
Scored across 310 tools
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.
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.
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.
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
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
Unofficial remote MCP server for Less Annoying CRM: OAuth 2.1, read-only grants, 10 tools.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
MCP server for Getfly CRM — customers, opportunities, orders, tickets and tasks.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceComplete 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.42MIT
- AlicenseCqualityCmaintenanceMCP server for smallinvoice.ch — Swiss SME invoicing and accounting with 146 tools and OAuth2 BYOC authentication.1009 npmMIT
- FlicenseNot gradedqualityDmaintenanceA 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.-
- AlicenseAqualityDmaintenanceA 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.2114 npmMIT