MailgentMCPTools Reference
mail.list_threads
List email threads in your inbox
Scope: mail:read
List conversation threads, most recently updated first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results (default 20, max 100) |
pageToken | string | No | Pagination cursor |
Example
Agent: "Show me recent conversations"
→ mail.list_threads({ limit: 5 })Returns
{
"threads": [
{
"threadId": "thd_a3f91b00c4e2d7e8",
"subject": "Question about pricing",
"messageCount": 3,
"updatedAt": "2026-03-28T14:30:00.000Z"
}
],
"count": 1
}REST Equivalent
GET /v0/threads