Oxygenius MCP server

Connect Claude, or any assistant that supports the Model Context Protocol, to your construction company's Oxygenius data: projects, third parties, planning, estimates, invoices, credit notes, tasks, e-mails and documents. Ask in plain language; the assistant only sees and does what you can see and do in Oxygenius.

Server URLhttps://mcp.oxygenius.be/mcp
Publisher
Oxygenius, management software for construction companies (oxygenius.be)
Transport
Streamable HTTP, stateless (POST /mcp)
Authentication
OAuth 2.1 (authorization code + PKCE), discovered through Protected Resource Metadata (RFC 9728)
Capabilities
81 tools (32 read-only, 49 write tools on opt-in); no resources or prompts
Data
In French; amounts in euros; dates and times in Belgian local time (Europe/Brussels)
Requirements
An Oxygenius account, in a company that has enabled the connector
About the language

Oxygenius is used by Belgian construction companies and its data is in French. The tool titles and descriptions the server sends to the model are therefore in French; this documentation gives an English summary of every tool next to the original text.

What you can do

Quick start

  1. Enable the connector for your company. An administrator opens Settings → AI integration in Oxygenius, reads the information notice and accepts it on behalf of the company. Details
  2. Add Oxygenius to your assistant. In Claude: Settings → Connectors, search for "Oxygenius" and click Connect. Details
  3. Sign in with your Oxygenius account and ask a question, for example: "Find Mr Dupont's project in Namur". Examples

Principles

PrincipleWhat it means
Same rights as in the applicationEvery user signs in with their own account. A tool requires the same permission as the matching Oxygenius screen; without it, the assistant does not even see the tool.
Read-only by defaultThe 49 write tools only appear once the company has explicitly enabled them. They go through the Oxygenius API, with the same checks as the web application.
Two-step consequential actionsNumbering an invoice, sending an e-mail, sending over Peppol: a prepare_* tool first shows what will happen, then the action requires a confirmation token valid for 10 minutes.
Company isolationThe company comes from the sign-in token, never from a parameter: a user only reaches their own company's data.
Reversible at any timeThe company can disable the connector in Oxygenius: access stops with the next request, for all its users.
Most useful tools to start with

search_dossiers and get_dossier for job sites, search_invoices for invoicing, search_planning_events for the planning, get_my_tasks and get_my_emails for day-to-day work, get_my_profile to know who is signed in.

In this documentation