MailgentMCPTools Reference
mail.list_messages
List emails in your agent's inbox
Scope: mail:read
List messages, newest first. Filter by labels.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results (default 20, max 100) |
labels | string | No | Comma-separated filter (e.g. "unread") |
pageToken | string | No | Pagination cursor |
Example
Agent: "Check if I have any new emails"
→ mail.list_messages({ labels: "unread" })Returns
{
"messages": [
{
"messageId": "...",
"from": ["customer@gmail.com"],
"subject": "Question",
"extractedText": "Hi, I need help with...",
"labels": ["received", "unread"]
}
],
"count": 1,
"nextPageToken": "..."
}The extractedText field has quoted history stripped — ideal for LLM input.
REST Equivalent
GET /v0/messages?labels=unread