All tools

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

Input

FieldTypeDescription
maxResultsnumberMaximum number of emails to retrieve (1-50, default 10)
filterunread | all | todayWhich emails to fetch: unread (default), all recent, or only today
querystringDeprecated — free-text search is not supported on Outlook and is ignored. Filter results yourself from the returned list.

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","query":"…"}}'
$run({ "tool": "read_emails", "input": {"maxResults":1,"filter":"unread","query":"…"} })