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.
https://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
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
Find a project
"Where is the Dupont job in Namur at?": status, steps, parties, estimates and invoices of the project.
Follow up invoicing
Overdue invoices, balances, amount left to invoice on an accepted estimate, credit notes.
Organise the planning
Who is where this week, schedule a crew on a job site, move an appointment.
Draft an estimate
Build an estimate from the item and assembly catalogue; Oxygenius computes prices, VAT and totals.
E-mails and tasks
Summarise your e-mails, prepare a reply, send a task to a colleague.
Read documents
Find a project document and read its text: handover reports, supplier quotes, UBL invoices.
Quick start
- 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
- Add Oxygenius to your assistant. In Claude: Settings → Connectors, search for "Oxygenius" and click Connect. Details
- Sign in with your Oxygenius account and ask a question, for example: "Find Mr Dupont's project in Namur". Examples
Principles
| Principle | What it means |
|---|---|
| Same rights as in the application | Every 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 default | The 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 actions | Numbering 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 isolation | The company comes from the sign-in token, never from a parameter: a user only reaches their own company's data. |
| Reversible at any time | The company can disable the connector in Oxygenius: access stops with the next request, for all its users. |
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
Getting connected
Enable the connector and add it to Claude, Claude Code or another MCP client.
Authentication & access
OAuth 2.1, discovery, tokens and per-tool permissions.
Tools
Reference of the 81 tools: parameters, results, annotations, permissions.
Examples
Real requests and the tools the assistant chains.
Security & data
Isolation, safeguards, data shared, retention and privacy.
Troubleshooting & FAQ
Common error messages and how to solve them.