Email · read_emails
Read emails
Read the connected mailbox (Outlook; Gmail is send-only).
- Price
- included
- Requirements
- Outlook
- set it up in Settings → Integrations
- Human approval
- No
- read or internal write
- Reliability
- Verified
- stable · 0.5 s
Input
| Field | Type | Description |
|---|---|---|
| maxResults | number | Maximum number of emails to retrieve (1-50, default 10) |
| filter | unread | all | today | Which emails to fetch: unread (default), all recent, or only today |
| messageId | string | Id of one email from a previous listing: returns it in full (plain-text body up to 12 000 characters, links, mentioned addresses, kind) instead of the list. |
| query | string | Deprecated — free-text search is not supported on Outlook and is ignored. Filter results yourself from the returned list. |
| mailbox | string | Optional: address of a SHARED mailbox (e.g. sav@company.fr) the connected account has access to. Omit to use the connected account's own mailbox. Requires the shared-mailbox permission on the Outlook connection; a 403 means the connection must be redone with it. |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"read_emails","input":{"maxResults":1,"filter":"unread","messageId":"…","query":"…"}}'$
run({ "tool": "read_emails", "input": {"maxResults":1,"filter":"unread","messageId":"…","query":"…"} })