Model Context Protocol (MCP) server for freee API integration
bexio MCP by usefulapi is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Read bexio contacts, invoices, quotes, bills, projects and journal; log time, draft invoices.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http bexio-mcp-by-usefulapi https://bexio.usefulapi.io/mcp
# 2 — ask your agent for something these tools do
# bexio_get_company_profile, bexio_get_current_user, bexio_list_users and 25 more
bexio MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http bexio-mcp-by-usefulapi https://bexio.usefulapi.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
28 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
The bexio company's profile: name, address, legal form, VAT (MWST) and UID numbers, contact details. Each bexio account has one profile.
No parameter schema on file.
The signed-in bexio user (id, name, email, superadmin/accountant flags). Its id is the default user_id of new records.
No parameter schema on file.
The company's bexio users (id, name, email). Use an id as user_id or owner of contacts, documents and timesheets.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
List or search contacts (customers, suppliers, persons, companies). Without filters it pages through all contacts; with filters it uses bexio's contact search (all filters must match). name_1 is the company name or a person's last name, name_2 a person's first name.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | name_1 (company name or last name) contains this text. |
| first_name | string | no | name_2 (a person's first name or a company's name addition) contains this text. |
| string | no | Main email contains this text. | |
| nr | string | no | Contact number equals this. |
| city | string | no | City contains this text. |
| postcode | string | no | Postcode equals this. |
| contact_type | string | no | Only companies or only persons. |
| updated_since | string | no | Changed on or after this date, yyyy-mm-dd. |
| archived | boolean | no | true = archived contacts only (default: active contacts). |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
One contact with its address, emails, phones, language, groups and remarks.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_id | integer | yes | The contact id (from bexio_list_contacts). |
| archived | boolean | no | true when the contact is archived. |
List or search sales invoices (number, contact, totals, open amount, dates, status). Statuses: draft, pending (issued, open), paid, partial (partially paid), canceled, unpaid (overdue reminder state). Without filters it pages through all invoices; with filters all must match.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | array | no | Only invoices with one of these statuses. |
| contact_id | integer | no | Only documents for this contact (from bexio_list_contacts). |
| user_id | integer | no | Only documents owned by this bexio user (from bexio_list_users). |
| document_nr | string | no | Document number contains this text (e.g. RE-00012). |
| title | string | no | Title contains this text. |
| valid_from_after | string | no | Document date (is_valid_from) on or after this date, yyyy-mm-dd. |
| valid_from_before | string | no | Document date (is_valid_from) on or before this date, yyyy-mm-dd. |
| updated_since | string | no | Changed on or after this date, yyyy-mm-dd. |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
One invoice with its positions (line items), taxes, totals, received payments and remaining amount.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| invoice_id | integer | yes | The invoice id (from bexio_list_invoices). |
The payments recorded on one invoice (date, amount, bank account, cash discount).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| invoice_id | integer | yes | The invoice id (from bexio_list_invoices). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
List or search quotes (Offerten): number, contact, totals, validity, status (draft, pending, confirmed, declined). With filters all must match.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | array | no | Only quotes with one of these statuses. |
| contact_id | integer | no | Only documents for this contact (from bexio_list_contacts). |
| user_id | integer | no | Only documents owned by this bexio user (from bexio_list_users). |
| document_nr | string | no | Document number contains this text (e.g. RE-00012). |
| title | string | no | Title contains this text. |
| valid_from_after | string | no | Document date (is_valid_from) on or after this date, yyyy-mm-dd. |
| valid_from_before | string | no | Document date (is_valid_from) on or before this date, yyyy-mm-dd. |
| updated_since | string | no | Changed on or after this date, yyyy-mm-dd. |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
One quote with its positions, taxes and totals.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quote_id | integer | yes | The quote id (from bexio_list_quotes). |
List or search sales orders (Aufträge): number, contact, totals, recurring flag, status (pending, done, partial, canceled). With filters all must match.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | array | no | Only orders with one of these statuses. |
| contact_id | integer | no | Only documents for this contact (from bexio_list_contacts). |
| user_id | integer | no | Only documents owned by this bexio user (from bexio_list_users). |
| document_nr | string | no | Document number contains this text (e.g. RE-00012). |
| title | string | no | Title contains this text. |
| valid_from_after | string | no | Document date (is_valid_from) on or after this date, yyyy-mm-dd. |
| valid_from_before | string | no | Document date (is_valid_from) on or before this date, yyyy-mm-dd. |
| updated_since | string | no | Changed on or after this date, yyyy-mm-dd. |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
One sales order with its positions, taxes and totals.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | integer | yes | The order id (from bexio_list_orders). |
List or search items / products (Artikel): code, name, sale and purchase price, tax, unit, stock levels. Use an id as article_id in a draft invoice.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Item name (intern_name) contains this text. |
| code | string | no | Item code (intern_code) contains this text. |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
List or search projects: number, name, contact, state, type, dates, budget. With filters all must match.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Project name contains this text. |
| contact_id | integer | no | Only projects of this contact. |
| state_id | integer | no | Only projects in this state (pr_state_id as returned on a project). |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
One project with its contact, state, type, dates, invoicing and budget settings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| project_id | integer | yes | The project id (from bexio_list_projects). |
List or search time tracking entries: date, duration, text, user, contact, project, business activity, billable flag. With filters all must match.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user_id | integer | no | Only entries of this bexio user. |
| contact_id | integer | no | Only entries for this contact. |
| project_id | integer | no | Only entries on this project. |
| business_activity_id | integer | no | Only entries of this business activity (client_service_id, from bexio_list_business_activities). |
| status_id | integer | no | Only entries with this timesheet status id. |
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
Business activities (Tätigkeiten) for time tracking: id, name, billable default, hourly rate. A timesheet needs one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_by | string | no | Sort field (default id). |
| descending | boolean | no | Sort descending (default ascending). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
The chart of accounts: account number, name, type (1 earning, 2 expenditure, 3 active/asset, 4 passive/liability, 5 complete/closing), default tax, active/locked flags.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
Accounting journal bookings: date, debit and credit account ids, description, amount, currency, base-currency amount, and the source document (ref_class, ref_id).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | no | Bookings on or after this date, yyyy-mm-dd. |
| to | string | no | Bookings up to this date, yyyy-mm-dd. |
| account_uuid | string | no | Only bookings on this account (its uuid from bexio_list_accounts). |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
VAT (MWST) tax codes: id, code, rate, type (sales_tax, pre_tax, ...), validity. For a draft invoice use an active sales tax (types sales_tax, scope active).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| scope | string | no | Only active or inactive taxes. |
| types | string | no | Only sales taxes or input (pre) taxes. |
| date | string | no | Only taxes active on this date, yyyy-mm-dd. |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
The company's bank accounts shown in bexio banking: name, bank, IBAN / QR-IBAN, currency, linked ledger account, QR-invoice mode.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
Currencies set up in bexio (id, code such as CHF or EUR, rounding), optionally with the exchange rate valid on a date. Use an id as currency_id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| with_exchange_rate | boolean | no | Embed each currency's exchange rate. |
| date | string | no | Validity date of the embedded exchange rate, yyyy-mm-dd. |
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
Accounting business (fiscal) years: start, end, status (open, locked, closed).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | integer | no | Results per page, 1-2000 (default 50). |
| offset | integer | no | Records to skip (default 0). Use next_offset from the previous reply. |
Supplier bills (Kreditoren / purchase bills): document number, vendor, title, status, gross/net, pending amount, bill and due date, overdue flag. status: DRAFTS, TODO (booked, not fully paid), PAID, OVERDUE.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Bill status filter. |
| search | string | no | Free-text search over vendor, vendor reference, currency, document number and title (3-255 characters). |
| vendor | string | no | Vendor name contains this text. |
| supplier_id | integer | no | Only bills of this supplier contact. |
| bill_date_from | string | no | Bill date on or after, yyyy-mm-dd. |
| bill_date_to | string | no | Bill date on or before, yyyy-mm-dd. |
| due_date_from | string | no | Due date on or after, yyyy-mm-dd. |
| due_date_to | string | no | Due date on or before, yyyy-mm-dd. |
| sort | string | no | Sort field. |
| descending | boolean | no | Sort descending (default ascending). |
| page | integer | no | Page number, 1-based (default 1). |
| limit | integer | no | Bills per page, 1-500 (default 50). |
WRITE: create a new contact (company or person) in bexio. Nothing existing is changed. For a person, name is the last name and first_name the first name. Owner and responsible user default to the signed-in user.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_type | string | yes | company or person. |
| name | string | yes | Company name, or a person's last name (name_1). |
| first_name | string | no | A person's first name, or a company's name addition (name_2). |
| street_name | string | no | Street name. |
| house_number | string | no | House number. |
| address_addition | string | no | Address addition (c/o, P.O. box). |
| postcode | string | no | Postcode. |
| city | string | no | City. |
| country_id | integer | no | bexio country id (1 = Switzerland in a default bexio setup). |
| string | no | Main email. | |
| phone | string | no | Landline phone. |
| mobile | string | no | Mobile phone. |
| website | string | no | Website URL. |
| remarks | string | no | Internal remarks. |
| language_id | integer | no | bexio language id of the contact's correspondence language. |
| contact_group_ids | array | no | Contact group ids. |
| user_id | integer | no | Responsible bexio user (default: the signed-in user). |
| owner_id | integer | no | Owner bexio user (default: the responsible user). |
WRITE: add a note (call log, meeting minutes, follow-up) to a contact and/or project in bexio. Nothing existing is changed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| subject | string | yes | Note subject. |
| info | string | no | Note text. |
| contact_id | integer | no | Attach to this contact. |
| project_id | integer | no | Attach to this project. |
| event_start | string | no | When it happened, local time yyyy-mm-dd HH:MM[:SS] (default: now, UTC). |
| user_id | integer | no | Author bexio user (default: the signed-in user). |
WRITE: log time in bexio: either date + duration (HH:MM), or start + end. Needs a business activity (bexio_list_business_activities). Nothing existing is changed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_activity_id | integer | yes | The business activity (client_service_id) from bexio_list_business_activities. |
| date | string | no | Work date, yyyy-mm-dd (with duration). |
| duration | string | no | Time worked as HH:MM, e.g. 01:30 (with date). |
| start | string | no | Start, local time yyyy-mm-dd HH:MM[:SS] (with end). |
| end | string | no | End, local time yyyy-mm-dd HH:MM[:SS] (with start). |
| text | string | no | What was done. |
| billable | boolean | no | Billable to the client (default true). |
| contact_id | integer | no | The client contact. |
| project_id | integer | no | The project. |
| status_id | integer | no | Timesheet status id (bexio's default when omitted). |
| user_id | integer | no | Whose time (default: the signed-in user). |
WRITE: create a DRAFT invoice in bexio for a contact, with custom, item (article) and text lines. It is never issued, sent or booked: the user reviews and issues it in bexio. Taxes must be active sales taxes (bexio_list_taxes with types sales_tax, scope active).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_id | integer | yes | The customer contact (from bexio_list_contacts). |
| positions | array | yes | 1-150 invoice lines. |
| title | string | no | Invoice title. |
| document_nr | string | no | Invoice number. Only when automatic numbering is OFF in bexio's settings (then it is required); leave empty with automatic numbering. |
| contact_sub_id | integer | no | A contact person of the customer. |
| project_id | integer | no | Link to this project. |
| valid_from | string | no | Invoice date, yyyy-mm-dd (default today). |
| valid_to | string | no | Due date, yyyy-mm-dd (default from the payment terms). |
| tax_mode | string | no | net = unit prices are net and VAT is added (default); gross = unit prices include VAT; exempt = the invoice is exempt from VAT. |
| currency_id | integer | no | Currency (from bexio_list_currencies); company default when omitted. |
| bank_account_id | integer | no | Bank account for the payment slip (from bexio_list_bank_accounts); default when omitted. |
| language_id | integer | no | Document language id; the contact's language when omitted. |
| payment_type_id | integer | no | Payment type id; default when omitted. |
| header | string | no | Text above the lines. |
| footer | string | no | Text below the lines. |
| reference | string | no | Customer reference shown on the invoice. |
| api_reference | string | no | Your own external reference (only visible through the API). |
| user_id | integer | no | Responsible bexio user (default: the signed-in user). |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install bexio MCP by usefulapi or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| bexio_get_company_profile | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_get_current_user | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_users | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_contacts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_get_contact | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_invoices | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_get_invoice | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_invoice_payments | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_quotes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_get_quote | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_orders | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_get_order | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_articles | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_projects | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_get_project | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_timesheets | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_business_activities | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_accounts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_journal | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_taxes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_bank_accounts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_currencies | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_business_years | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_list_bills | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| bexio_create_contact | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| bexio_create_note | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| bexio_create_timesheet | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| bexio_create_draft_invoice | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.21.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish bexio MCP by usefulapi can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.