MCP

Connect Claude to your Billit account and ask questions about your invoices, customers, and suppliers in plain language.

The Billit connector is a remote MCP server built and operated by Billit. It gives Claude read-only access to the Billit account you sign in with: Claude can look up and summarize your data, but it can never create, modify, send, or delete anything.

📘
Read-only by design
Every tool in this connector is a read operation. No documents are created, no invoices are sent, no records are changed — on Billit or on the Peppol network. Write capabilities are not part of this connector.

What Claude can do

Tool	What it does
Get account information	Lists the Billit companies your account can act for, so Claude can work with the right one on multi-company accounts.
List orders	Finds sales and purchase invoices and credit notes — filter by direction, date, payment status, amount, or counterparty, or search free text.
Get order	Retrieves the full detail of one document: order lines, VAT breakdown, payment reference, payment status, and e-invoice delivery status.
Summarize orders	Aggregates totals per customer or supplier, e.g. "how much did I spend per supplier this year?"
List parties	Lists the customers and suppliers in your account.
Get party	Retrieves one customer or supplier in detail: addresses, VAT number, IBAN/BIC, contact info, and Peppol identifier.
Search companies	Searches the public company registry (CBE/KBO) by name or VAT number — for companies not yet in your account.
Check Peppol participant	Checks whether a company can receive electronic invoices over the Peppol network, and which document types it supports.

Example prompts

"Show my unpaid invoices from the last quarter."
"How much did I spend per supplier this year?"
"Can I send an e-invoice to Acme NV?"

Developer reference: the connector is built on the Billit REST API. API-level documentation, including the underlying /v1/orders and /v1/parties endpoints and OData filtering, lives there.

What data is accessed

When you use the connector, Claude can read the following data from the Billit company (or companies) you have access to:

Invoices, credit notes, and orders, including line items, amounts, VAT details, and payment status
Customer and supplier records, including addresses, VAT numbers, bank account numbers, and contact details
The list of companies linked to your Billit account

It can also query two public sources that contain no account data: the Belgian company registry (CBE/KBO) and the Peppol network's public participant directory (SMP lookups).

The connector never accesses your Billit password, and it cannot reach data outside the companies your Billit user is authorized for. All traffic between Claude, the connector, and the Billit API is encrypted with HTTPS/TLS.

Connecting your account

In Claude, open Settings → Connectors (or find Billit in the connectors directory) and choose Connect.
You are redirected to Billit's secure sign-in page. Log in with your own Billit credentials — they are never shared with Claude or Anthropic.
Review and approve the consent screen. This grants Claude read-only access via OAuth; no password is stored.
Return to Claude and start asking questions.

Multi-company accounts

If your Billit account manages several companies (for example, as an accountant), Claude sees the full list and can act for any company that is API-enabled. Just name the company in your prompt — "show the unpaid invoices for

Revoking access

You can disconnect at any time, from either side:

In Claude: Settings → Connectors → Billit → Disconnect.

Revoking access invalidates the OAuth tokens immediately; Claude retains no way to reach your Billit data afterwards.

⚠️
A note on AI-generated answers
Claude reads real data from your account, but its summaries and interpretations are generated by an AI model and can contain mistakes. For financial, tax, or compliance decisions, verify the underlying documents in my.billit.be.