Billbee

At a glance

Availability: Experimental (how to enable).
Authentication: Basic auth.
Connection: HTTP Basic auth with BILLBEE_USERNAME as the username and BILLBEE_API_PASSWORD as the password.
Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Variable	Required	Description
`BILLBEE_USERNAME`	Yes	Billbee account username (email), used as the HTTP Basic username Docs.
`BILLBEE_API_PASSWORD`	Yes	Billbee API password set under Settings → API (not the account login password), used as the HTTP Basic password Docs.
`BILLBEE_API_KEY`	Yes	Billbee developer API key identifying your application, sent in the X-Billbee-Api-Key header (request via [email protected]) Docs.

Setup

Create a Billbee account: Sign up at https://app.billbee.io - a free trial is available for testing.
Activate the API and set an API password: In Billbee open Settings → API (https://app.billbee.io/app_v2/settings/api/general), activate the API module, and set a dedicated API password. This is separate from your account login password.
Request an API key: Email [email protected] with a short note about what you are building to receive a developer API key. This key identifies your application and is sent as the X-Billbee-Api-Key header.
Store the credentials: Add BILLBEE_USERNAME (your Billbee login email), BILLBEE_API_PASSWORD, and BILLBEE_API_KEY to your .env file, then run the List Orders tool to verify access.

Provider notes

Every request needs BOTH HTTP Basic auth (username + API password) AND the X-Billbee-Api-Key header
Rate limit: max 2 requests per second per API key + user combination; some endpoints have stricter per-call throttles
Responses wrap payloads in a Data field alongside Paging and ErrorMessage fields

Provider API reference.

Tools

Tool	Access	Description
List Orders `billbee__list_orders`	Read	List orders across all connected shops, optionally filtered by date range, modification time, or order state
Get Order `billbee__get_order`	Read	Get a single order with positions, addresses, and payment details by its internal Billbee ID
Update Order State `billbee__update_order_state`	Write	Change the main state of an order, e.g. mark it as confirmed, paid, or shipped
List Products `billbee__list_products`	Read	List products (articles) in the Billbee account
List Customers `billbee__list_customers`	Read	List customers in the Billbee account
List Invoices `billbee__list_invoices`	Read	List invoices with positions and amounts over a date range - the export feed into accounting tools. Throttled to 1 request per minute for the same page and minInvoiceDate.
Get Order States `billbee__get_order_states`	Read	List all defined order state IDs and names - resolves the NewStateId values used by Update Order State
Update Stock `billbee__update_stock`	Write	Set the absolute stock quantity of a product by SKU or Billbee product ID - the most common multichannel write; the change is pushed to connected shops

Verify the connection

Call a read tool such as billbee__list_orders with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.

Get started

APIs

REST API

GraphQL API

MCP API

At a glance

Credentials

Setup

Provider notes

Tools

Verify the connection

​At a glance

​Credentials

​Setup

​Provider notes

​Tools

​Verify the connection

At a glance

Credentials

Setup

Provider notes

Tools

Verify the connection