API ReferenceMessages
Get Message
GET /v0/messages/:messageId
Get a specific email by its messageId.
Scope: mail:read
GET /v0/messages/{messageId}Response 200
{
"messageId": "<abc123@gmail.com>",
"threadId": "thd_f8e2a1c4d7b90e3f",
"inboxId": "agent-x8k2m@mailgent.dev",
"from": ["customer@gmail.com"],
"to": ["agent-x8k2m@mailgent.dev"],
"cc": [],
"subject": "Question about pricing",
"text": "Hi, I'd like to know about your enterprise plan.\n\nBest,\nJohn",
"extractedText": "Hi, I'd like to know about your enterprise plan.",
"labels": ["received", "unread"],
"createdAt": "2026-03-28T12:00:00.000Z"
}404 Not Found
Returned when the messageId doesn't exist or belongs to a different identity.
{
"error": "not_found",
"message": "Message not found",
"status": 404
}cURL
curl https://api.mailgent.dev/v0/messages/%3Cabc123%40gmail.com%3E \
-H "Authorization: Bearer mgent-your-api-key"MCP
Tool: mail.get_message