# Ondes PRO Email: a mailbox your AI can work through

> Connect Claude, ChatGPT or Cursor to Ondes PRO mailboxes over MCP: search, read, reply, sort. Your own domain or a linked mailbox, with a simulated test mode.

Updated on 2026-10-21 · The Ondes PRO team · https://ondes.pro/en/integrations/mcp/modules/email

**Ondes PRO email** is reachable by your AI assistant through your workspace’s **MCP server**. Claude, ChatGPT, Cursor or Visual Studio Code can **search** your messages, **read** them, **reply** in the right thread, **move** and **flag** them — on addresses at your own domain, or on an existing mailbox you have linked. By default every send from the assistant is **simulated** first: nothing leaves without an explicit call.

## Handle a delivery complaint without leaving the chat

_Example conversation · demo data (Atelier Lumen)_

> **You** : Le Comptoir des Marées emailed us about late bedside lamps. Find the message, tell me what they want and draft a reply: delivery on Thursday, usual carrier.
>
> 🔧 `ondes_appeler` `GET mail/boites/messages/?boite=…&search=Comptoir des Marées` — 2 messages, the latest from Friday.
>
> 🔧 `ondes_appeler` `GET mail/boites/message/?boite=…` — message read. In test mode, it is not marked as read.
>
> **Assistant** : Le Comptoir des Marées is waiting for **12 bedside lamps** promised for 16 October and wants a firm date before opening its new dining room. Draft reply: apologies for the delay, delivery on **Thursday 22 October** with your usual carrier, tracking number sent on dispatch. Shall I send it as a test?
>
> **You** : Yes, show me what would go out.
>
> 🔧 `ondes_appeler` `POST mail/boites/envoyer/` with `repond_a` — **simulated**: recipient, “Re:” subject and thread worked out, nothing sent.
>
> **Assistant** : The reply would go from contact@ to Le Comptoir des Marées, in the same thread, subject “Re: Bedside lamp order”. Send it for real and file both messages under Deliveries?
>
> **You** : Send, and file them.
>
> 🔧 `ondes_appeler` Real send with `reel: true`, then `deplacer/` to Deliveries — the response also returns what is needed to undo the move.
>
> **Assistant** : Sent and filed. If you would rather keep those messages in the inbox, I can undo the move.

## Connecting a mailbox to an AI: what the MCP server allows

An **email MCP server** turns your assistant into a colleague who can deal with the post: find a conversation from a name or a word in the body, summarise a thread, write a reply that keeps the right subject and thread, file what has been handled, mark as read what needs nothing, or flag spam. It works on the real, current mailbox, not on a forwarded copy.

In Ondes PRO, email sits next to the CRM, invoicing and orders, so an assistant reading a complaint can check the order or the client record before answering. A standalone mail connector cannot do that. The [MCP server overview](https://ondes.pro/en/integrations/mcp) introduces the eight tools shared by every module.

## The mail actions the assistant calls

They belong to the API’s `mail/boites` resource, take the mailbox in the `boite` parameter and all go through the `ondes_appeler` tool.

| Action | Use | Good to know |
| --- | --- | --- |
| `messages/` | List a folder, or search with `search` | Server-side search across subject, addresses and body; `folder=tous` covers the whole mailbox except spam and trash. |
| `message/` | Read a message | In test mode, reading does not mark it as read. |
| `envoyer/` | Write, reply, forward | With `repond_a`, thread headers are derived from the original message. |
| `deplacer/` | File into a folder | The response includes the body that undoes the move. |
| `flags/`, `tout-lu/` | Mark read, important… | A missing message identifier is reported, never silently skipped. |
| `dossiers/` | List, create, rename folders | An unknown folder is rejected instead of falling back to the inbox. |

## Addresses at your own domain, or an existing mailbox

Addresses created in Ondes PRO live on **your company’s domain** (contact@your-company.com), signed so they land in the inbox rather than in spam. They can be driven over MCP like everything else.

Already on Gmail, OVH or IONOS? You can **link** that mailbox to Ondes PRO over IMAP: it then shows up in the Email module, in the built-in assistant and for your MCP-connected assistant, with the same actions. Microsoft 365 and Outlook are not supported today, because they require their own OAuth sign-in.

## Safeguards: your AI sends nothing by mistake

- **Simulated test mode**: on mailboxes, `ondes_appeler` works in test mode by default. Reads hit the real mailbox with no side effects; writes (send, move, flag) are simulated and the response says so (`simule: true`).
- **A real send is explicit**: it takes `reel: true`, which your AI client normally asks you to approve.
- **Other people’s mail stays private**: managing colleagues’ addresses does not mean reading their mail. The assistant only opens mailboxes you can access yourself, including shared mailboxes assigned to you.
- **No arbitrary sender**: the API only sends from a mailbox linked to you; `ondes_impossible` reminds the assistant before it tries anything else.
- **Every call is logged** in your workspace, flagged as coming from MCP.

## What about email marketing? Campaigns, lists and contacts

Beyond the inbox, the API exposes email marketing: `emails/campagnes`, `emails/listes`, `emails/contacts` and `emails/modeles`. Your assistant can build a list of clients in one sector, write a template or propose a campaign. One-off sends (`emails/envois`) have a test twin: a trial reaches no real recipient.

For messages that should go out on their own — a follow-up after an order, a quote reminder — look at [automations](https://ondes.pro/en/integrations/mcp/modules/automations) instead, which the assistant prepares as drafts.

## Keep exploring

- [CRM](https://ondes.pro/en/integrations/mcp/modules/crm) — Customer records, follow-up notes, pipeline and reminders kept up to date by your assistant.
- [Automations](https://ondes.pro/en/integrations/mcp/modules/automations) — Describe a flow in one sentence: your AI drafts and tests it, you review and publish it.
- [ChatGPT](https://ondes.pro/en/integrations/mcp/clients/chatgpt) — ChatGPT developer mode accepts your workspace as an MCP connector, over OAuth.
- [MCP server security](https://ondes.pro/en/integrations/mcp/security) — OAuth 2.1, short-lived tokens, instant revocation and write safeguards: what your IT team needs to know.

## Frequently asked questions

### Can an AI reply to my emails?

Yes. Connected to Ondes PRO over MCP, your assistant finds a message, reads it and drafts a reply in the same thread. By default the send is simulated: the response shows what would go out, and a real send needs an explicit call.

### Can the AI read my colleagues’ email?

No. It only opens mailboxes the connected person can access, shared mailboxes included. Managing the team’s addresses does not grant access to their content.

### My email is on Gmail or OVH. Does it work?

Yes, by linking it to Ondes PRO over IMAP from the mailboxes screen. It then becomes available to the Email module and to your MCP assistant with the same actions. Microsoft 365 and Outlook are not supported for now.

### How does test mode work for email?

Reads hit the real mailbox with no side effects (a message you read is not marked as read); sends, moves and flags are simulated and the response says so. Acting for real takes `reel: true`.

### Can I search the whole mailbox at once?

Yes: search runs server-side across subject, addresses and body, and `folder=tous` goes through every folder except spam and trash. Results are paginated, each tagged with its folder.

### Is email over MCP included in my plan?

Yes. The Email module and the MCP server are included in every Ondes PRO plan. Mailbox storage shares your workspace’s storage allowance. See [pricing](https://ondes.pro/en/pricing).