# Oxygenius MCP server > Remote MCP server (Streamable HTTP, OAuth 2.1) giving Claude and other MCP clients access to a construction company's Oxygenius data: projects (dossiers), third parties, planning and calendar, estimates, invoices, credit notes, Peppol e-invoicing, items and stock, tasks, e-mails and documents. Endpoint: https://mcp.oxygenius.be/mcp. 81 tools: 32 read-only, 49 write tools enabled per company. Data, tool titles and descriptions are in French. Documentation is available in French (default) and English (under /en/). Every user only sees the tools their Oxygenius permissions allow; consequential actions use a prepare_* tool and a confirmation token. ## Documentation - [Overview](https://docs.oxygenius.be/mcp/en/) - [Getting connected](https://docs.oxygenius.be/mcp/en/connect/) - [Authentication & access](https://docs.oxygenius.be/mcp/en/authentication/) - [Usage examples](https://docs.oxygenius.be/mcp/en/examples/) - [Security & data](https://docs.oxygenius.be/mcp/en/security/) - [Technical reference](https://docs.oxygenius.be/mcp/en/reference/) - [Troubleshooting & FAQ](https://docs.oxygenius.be/mcp/en/troubleshooting/) - [Support & legal](https://docs.oxygenius.be/mcp/en/support/) - [Tools reference](https://docs.oxygenius.be/mcp/en/tools/): all tools grouped by domain ## Machine-readable - [tools.json](https://docs.oxygenius.be/mcp/tools.json): exact tools/list entries with input and output schemas, annotations and access rules - [server.json](https://docs.oxygenius.be/mcp/server.json): MCP registry server description ## Tools: Projects (job sites) - [search_dossiers](https://docs.oxygenius.be/mcp/en/tools/search_dossiers/): read-only. Lists or searches the company's projects by reference, title, external references, site address and the name, address or phone of linked third parties, newest first. - [get_dossier](https://docs.oxygenius.be/mcp/en/tools/get_dossier/): read-only. Returns a project: status, site type, manager, site address, current step and procedure steps, linked third parties and counts of estimates, invoices and credit notes. - [create_dossier](https://docs.oxygenius.be/mcp/en/tools/create_dossier/): write. Creates a project for a customer, with its procedure steps, optional linked third parties, manager, site type and site address. - [update_dossier](https://docs.oxygenius.be/mcp/en/tools/update_dossier/): write. Updates a project's title, manager, site type, external references, origin or own site address; only the given fields change. ## Tools: Third parties (customers, suppliers, contacts) - [search_tiers](https://docs.oxygenius.be/mcp/en/tools/search_tiers/): read-only. Lists or searches customers, suppliers and contacts by reference, name, e-mail, address or phone. - [get_tiers](https://docs.oxygenius.be/mcp/en/tools/get_tiers/): read-only. Returns a third party's contact details, address, VAT and company numbers, VAT regime, payment term and recent projects. Bank details are never returned. - [create_tiers](https://docs.oxygenius.be/mcp/en/tools/create_tiers/): write. Creates a customer, supplier or contact. If similar third parties exist, nothing is created and they are returned as possible duplicates. - [update_tiers](https://docs.oxygenius.be/mcp/en/tools/update_tiers/): write. Updates a third party; only the given fields change. Bank details, Peppol identifiers, discount and remarks are never changed by this tool. - [check_vat](https://docs.oxygenius.be/mcp/en/tools/check_vat/): write. Checks a European VAT number with the European Commission's VIES service and returns the registered name and address, and the third parties that already use it. ## Tools: Planning & calendar - [search_planning_events](https://docs.oxygenius.be/mcp/en/tools/search_planning_events/): read-only. Lists or searches planning entries (job sites, crews) over a period, one result per day with the people assigned. Next 30 days by default, 366 days at most. - [get_planning_event](https://docs.oxygenius.be/mcp/en/tools/get_planning_event/): read-only. Returns a planning entry: times, type, site state, people assigned, description, project with site address and customer, linked estimates. - [search_calendar_events](https://docs.oxygenius.be/mcp/en/tools/search_calendar_events/): read-only. Lists or searches calendar events (appointments, office, leave) over a period. Other users' private events show as "Private" without content. - [get_calendar_event](https://docs.oxygenius.be/mcp/en/tools/get_calendar_event/): read-only. Returns a calendar event: times, type, people, description and linked project. Another user's private event stays hidden. - [get_agenda_lists](https://docs.oxygenius.be/mcp/en/tools/get_agenda_lists/): read-only. Returns the event types, site states and resources (people and equipment) of the planning or the calendar, with the identifiers the write tools expect. - [create_planning_event](https://docs.oxygenius.be/mcp/en/tools/create_planning_event/): write. Creates a planning entry on one day or consecutive days, at the same times, for people or equipment. No confirmation is sent to the customer. - [update_planning_event](https://docs.oxygenius.be/mcp/en/tools/update_planning_event/): write. Updates one day of a planning entry, or all its days (times only). Only the given fields change. - [create_calendar_event](https://docs.oxygenius.be/mcp/en/tools/create_calendar_event/): write. Creates a calendar event on one day or consecutive days for one or more people. No confirmation is sent to the customer. - [update_calendar_event](https://docs.oxygenius.be/mcp/en/tools/update_calendar_event/): write. Updates one day of a calendar event, or all its days (times only). Another user's private event cannot be changed. ## Tools: Estimates (quotes) - [search_estimates](https://docs.oxygenius.be/mcp/en/tools/search_estimates/): read-only. Lists or searches estimates, including amendments and versions, newest first, with filters by project, customer, status and dates. - [get_estimate](https://docs.oxygenius.be/mcp/en/tools/get_estimate/): read-only. Returns an estimate: customer, amounts and VAT breakdown, lines, amendments, linked invoices and credit notes and, once accepted, the amount left to invoice. - [create_estimate](https://docs.oxygenius.be/mcp/en/tools/create_estimate/): write. Creates an empty draft estimate for a project, billed to the project's billing third party. - [update_estimate](https://docs.oxygenius.be/mcp/en/tools/update_estimate/): write. Updates an estimate's header (name, dates, billed third party) or applies a margin or discount to all its lines. - [add_estimate_lines](https://docs.oxygenius.be/mcp/en/tools/add_estimate_lines/): write. Adds titles, subtitles, free lines and catalogue items or assemblies to an estimate; Oxygenius recalculates all amounts. - [update_estimate_lines](https://docs.oxygenius.be/mcp/en/tools/update_estimate_lines/): write. Updates estimate lines (label, description, quantity, price, margin, discount, VAT, unit); Oxygenius recalculates all amounts. - [remove_estimate_lines](https://docs.oxygenius.be/mcp/en/tools/remove_estimate_lines/): write. Removes estimate lines, together with their child lines; Oxygenius recalculates all amounts. - [create_estimate_version](https://docs.oxygenius.be/mcp/en/tools/create_estimate_version/): write. Creates a new editable version of an estimate under the same number, like the "New version" button. The original is unchanged. - [print_estimate](https://docs.oxygenius.be/mcp/en/tools/print_estimate/): write. Generates the estimate PDF and files it in the project's documents; a draft estimate becomes "printed". Nothing is sent to the customer. - [prepare_estimate_decision](https://docs.oxygenius.be/mcp/en/tools/prepare_estimate_decision/): write. Changes nothing: shows the effects of recording the customer's acceptance or refusal and returns a 10-minute confirmation token. - [accept_estimate](https://docs.oxygenius.be/mcp/en/tools/accept_estimate/): write. Records the customer's acceptance prepared by prepare_estimate_decision; project automations (steps, tasks, work sheet) run. - [refuse_estimate](https://docs.oxygenius.be/mcp/en/tools/refuse_estimate/): write. Records the customer's refusal prepared by prepare_estimate_decision. ## Tools: Invoices - [search_invoices](https://docs.oxygenius.be/mcp/en/tools/search_invoices/): read-only. Lists or searches invoices with their outstanding balance and payment delay, including overdue invoices. - [get_invoice](https://docs.oxygenius.be/mcp/en/tools/get_invoice/): read-only. Returns an invoice: customer, amounts, retention, balance, payments received, structured reference, lines, invoiced estimate and credit notes. - [create_invoice](https://docs.oxygenius.be/mcp/en/tools/create_invoice/): write. Creates an unnumbered draft invoice: free, or from an accepted estimate (deposit, progress or final). Nothing is numbered or sent. - [update_invoice](https://docs.oxygenius.be/mcp/en/tools/update_invoice/): write. Updates a draft invoice's header: date, due date, payment term, purchase order, billed third party. - [add_invoice_lines](https://docs.oxygenius.be/mcp/en/tools/add_invoice_lines/): write. Adds lines to a draft invoice; Oxygenius recalculates all amounts. - [update_invoice_lines](https://docs.oxygenius.be/mcp/en/tools/update_invoice_lines/): write. Updates lines of a draft invoice; Oxygenius recalculates all amounts. - [remove_invoice_lines](https://docs.oxygenius.be/mcp/en/tools/remove_invoice_lines/): write. Removes lines from a draft invoice, together with their child lines. - [prepare_invoice_finalization](https://docs.oxygenius.be/mcp/en/tools/prepare_invoice_finalization/): write. Changes nothing: shows what numbering a draft invoice will do (legal number, PDF and UBL, accounting) and returns a 10-minute confirmation token. - [finalize_invoice](https://docs.oxygenius.be/mcp/en/tools/finalize_invoice/): write. Gives a draft invoice its final legal number and prints it, as prepared by prepare_invoice_finalization. Nothing is sent to the customer. ## Tools: Credit notes - [search_credit_notes](https://docs.oxygenius.be/mcp/en/tools/search_credit_notes/): read-only. Lists or searches credit notes, newest first, with filters by project, invoice, customer, status and dates. - [get_credit_note](https://docs.oxygenius.be/mcp/en/tools/get_credit_note/): read-only. Returns a credit note: customer, credited invoice, amounts and VAT breakdown, lines. - [create_credit_note](https://docs.oxygenius.be/mcp/en/tools/create_credit_note/): write. Creates an unnumbered draft credit note, free or from a numbered invoice that is neither paid nor cancelled. - [update_credit_note](https://docs.oxygenius.be/mcp/en/tools/update_credit_note/): write. Updates a draft credit note's header: date and billed third party. - [add_credit_note_lines](https://docs.oxygenius.be/mcp/en/tools/add_credit_note_lines/): write. Adds lines to a draft credit note; Oxygenius recalculates all amounts. - [update_credit_note_lines](https://docs.oxygenius.be/mcp/en/tools/update_credit_note_lines/): write. Updates lines of a draft credit note; Oxygenius recalculates all amounts. - [remove_credit_note_lines](https://docs.oxygenius.be/mcp/en/tools/remove_credit_note_lines/): write. Removes lines from a draft credit note, together with their child lines. - [prepare_credit_note_finalization](https://docs.oxygenius.be/mcp/en/tools/prepare_credit_note_finalization/): write. Changes nothing: shows what numbering a draft credit note will do, including its effect on the credited invoice, and returns a 10-minute confirmation token. - [finalize_credit_note](https://docs.oxygenius.be/mcp/en/tools/finalize_credit_note/): write. Gives a draft credit note its final legal number and prints it, as prepared by prepare_credit_note_finalization. ## Tools: E-invoicing & accountant - [prepare_peppol_send](https://docs.oxygenius.be/mcp/en/tools/prepare_peppol_send/): write. Changes nothing: shows how a numbered invoice or credit note will be sent over Peppol (or Mercurius) and returns a 10-minute confirmation token. - [send_peppol](https://docs.oxygenius.be/mcp/en/tools/send_peppol/): write. Sends the prepared invoice or credit note over Peppol (or Mercurius). Irreversible; daily limit per user. - [prepare_accountant_send](https://docs.oxygenius.be/mcp/en/tools/prepare_accountant_send/): write. Changes nothing: shows how a numbered invoice or credit note will be sent to the company's accountant and returns a 10-minute confirmation token. - [send_to_accountant](https://docs.oxygenius.be/mcp/en/tools/send_to_accountant/): write. Sends the prepared invoice or credit note (UBL file) to the company's accountant by e-mail. Daily limit per user. ## Tools: Items, assemblies & stock - [search_items](https://docs.oxygenius.be/mcp/en/tools/search_items/): read-only. Lists or searches catalogue items and assemblies alphabetically, with their sale price and, with the Stock module, the quantity in stock. - [get_item](https://docs.oxygenius.be/mcp/en/tools/get_item/): read-only. Returns an item or assembly: description, sale prices, unit, category, suppliers and composition. The purchase price requires the profitability permission. - [get_item_stock](https://docs.oxygenius.be/mcp/en/tools/get_item_stock/): read-only. Returns an item's stock (Stock module): quantity per location, state against thresholds, reorder quantity and latest movements. ## Tools: Tasks - [search_tasks](https://docs.oxygenius.be/mcp/en/tools/search_tasks/): read-only. Lists or searches the tasks visible to the user, urgent ones first; to-do tasks by default. - [get_my_tasks](https://docs.oxygenius.be/mcp/en/tools/get_my_tasks/): read-only. Returns the signed-in user's tasks, like the dashboard widget: received, sent or scheduled. - [get_task](https://docs.oxygenius.be/mcp/en/tools/get_task/): read-only. Returns a task and the history of its thread: creation, replies, transfers and closing. - [list_task_types](https://docs.oxygenius.be/mcp/en/tools/list_task_types/): read-only. Lists the active task types; with assigneeId, only those that can be assigned to that person. - [create_task](https://docs.oxygenius.be/mcp/en/tools/create_task/): write. Creates a task on a project for one or more people (one task each, each notified). - [reply_task](https://docs.oxygenius.be/mcp/en/tools/reply_task/): write. Replies to a to-do task: the reply becomes a new task for the sender and the original is closed. - [transfer_task](https://docs.oxygenius.be/mcp/en/tools/transfer_task/): write. Transfers a to-do task to another person; the original task is closed. - [set_task_pinned](https://docs.oxygenius.be/mcp/en/tools/set_task_pinned/): write. Pins (marks urgent) or unpins a to-do task, for everyone who sees it. - [update_my_task](https://docs.oxygenius.be/mcp/en/tools/update_my_task/): write. Updates a task the user created and that is still to do: content, urgency, scheduling, assignee or type. ## Tools: E-mails - [search_emails](https://docs.oxygenius.be/mcp/en/tools/search_emails/): read-only. Lists or searches e-mails of the Oxygenius mailbox (synchronised Microsoft 365 mailboxes), or those filed in a project. - [get_my_emails](https://docs.oxygenius.be/mcp/en/tools/get_my_emails/): read-only. Returns the signed-in user's own mailbox, inbox by default, newest first. - [get_email](https://docs.oxygenius.be/mcp/en/tools/get_email/): read-only. Returns an e-mail: sender, recipients, dates, project, plain-text body and attachment metadata. The e-mail is not marked as read. - [list_dossier_emails](https://docs.oxygenius.be/mcp/en/tools/list_dossier_emails/): read-only. Lists the e-mails filed in a project, like its Mails tab. - [create_email_draft](https://docs.oxygenius.be/mcp/en/tools/create_email_draft/): write. Creates a draft e-mail: new, reply, reply all or forward, with the user's signature. Nothing is sent. - [create_document_email](https://docs.oxygenius.be/mcp/en/tools/create_document_email/): write. Creates the draft that sends a printed estimate or a numbered invoice or credit note to its customer, with the PDF attached. Nothing is sent. - [update_email_draft](https://docs.oxygenius.be/mcp/en/tools/update_email_draft/): write. Updates a draft created by the user: recipients, subject, message, type, sending mailbox. - [attach_documents_to_email](https://docs.oxygenius.be/mcp/en/tools/attach_documents_to_email/): write. Attaches copies of Oxygenius documents the user can see to a draft; no file comes from the conversation. - [remove_email_attachments](https://docs.oxygenius.be/mcp/en/tools/remove_email_attachments/): write. Removes attachments from a draft; the original documents remain. - [prepare_email_send](https://docs.oxygenius.be/mcp/en/tools/prepare_email_send/): write. Changes nothing: shows the e-mail exactly as it will leave, with warnings, and returns a 10-minute confirmation token. - [send_email](https://docs.oxygenius.be/mcp/en/tools/send_email/): write. Sends the draft prepared by prepare_email_send. Irreversible; daily limit per user. ## Tools: Documents - [list_dossier_documents](https://docs.oxygenius.be/mcp/en/tools/list_dossier_documents/): read-only. Lists a project's files (imported documents, generated estimates and invoices, photos, filed attachments), limited to the document types the user's roles allow. - [read_document](https://docs.oxygenius.be/mcp/en/tools/read_document/): read-only. Reads the text of a project document or e-mail attachment (PDF text layer, text, CSV, XML including UBL, JSON, HTML), part by part. - [get_document_download_link](https://docs.oxygenius.be/mcp/en/tools/get_document_download_link/): read-only. Returns a direct, read-only download link to a document, valid for a few minutes. ## Tools: Profile & reference data - [get_my_profile](https://docs.oxygenius.be/mcp/en/tools/get_my_profile/): read-only. Returns the signed-in user's profile: name, work e-mail and phone, job title, company, roles and active modules. - [search_users](https://docs.oxygenius.be/mcp/en/tools/search_users/): read-only. Searches active staff by name and returns the identifier to pass to tools that designate a person (task recipient, project manager). - [get_reference_lists](https://docs.oxygenius.be/mcp/en/tools/get_reference_lists/): read-only. Returns the active values of the third-party and project form lists: VAT regimes, payment terms, roles, site types and procedures.