Find specific messages or attachments and read them
No company's docs show a full fit yet. The listings below do the job with a limit, or not at all.
What counts as done
The matching messages, with full plain-text bodies and any attachment content, with no matching message silently dropped and attachments not truncated.
Measured, for our own tests: returned in at most 3 calls for up to 50 messages. No docs we read state these figures, so they don't count against a listing here.
How agents ask for it: find the invoice from last March
, what did Alice say about the contract
, pull every autopay email from the past year
, get the PDF from that email
Does the job, with a limit 10
It does the job, but something in the docs or a user's account will get in an agent's way. The limit is named in each row.
| Listing | Why |
|---|---|
| Aurinko Email API F Yoxel, Inc. | GET /v1/email/messages takes q with from, subject, has:attachment and dates, but bodyType works on Google and Office 365 only, other providers return a snippet flagged in omitted[], label: is Gmail-only, and attachments need a separate call each. source |
| email-agent-mcp B UseJunior | search_emails runs full-text search, read_email returns the body as Markdown with no size cap on that path, and download_attachment returns base64 inline, but each message and attachment is its own call, so 50 messages with attachments exceed 3 calls. source |
| EmailEngine BB Postal Systems OÜ, Narva mnt 5, 10117 Tallinn, Estonia, registry code 14971894 | search_messages runs structured search and get_attachment returns an attachment inline as base64, but search covers one folder (\All only on Gmail), MCP bodies come back as sanitized HTML with a size budget rather than plain text, and each message is a get_message call. source |
| Fastmail API (JMAP) C Fastmail Pty Ltd, ACN 142 646 580, PO Box 234, Collins Street West, VIC 8007, Australia | One JMAP request can chain Email/query (filters inMailbox, from, after, hasAttachment) and Email/get with fetchTextBodyValues for 50 messages, flagging isTruncated, but attachment content is a separate blob download rather than inline, and maxBodyValueBytes must be set high to avoid truncation. source |
| Gmail API A Google LLC | messages.list with q returns IDs only, so bodies need a messages.get per ID (batchable) and attachments a separate attachments.get; bodies come as base64 MIME parts, so HTML-only mail has no plain text to return. source |
| Himalaya C No legal entity found. Copyright Clément DOUIN (soywod) | envelope search takes a query language and attachment_download now returns content on stdout, but each message is a separate message read, and accounts showed has-attachment dropping messages silently (acc-20, closed today) and one-mailbox search (acc-19, closed 8 November), both after the last release, 2.2.1. source |
| Nylas Email API A Nylas, Inc. | GET /messages filters by from, to, subject, has_attachment and dates and returns bodies, with Clean messages converting HTML to text and attachments downloadable, but the spec says Microsoft grants sometimes don't return messages matching to or cc, and native search combines only with in, limit and page_token. source |
| Outlook Mail (Microsoft Graph) C Microsoft Corporation | List messages takes $filter or $search with $top up to 1,000 and Prefer outlook.body-content-type=text for plain bodies, and attachments return contentBytes or $value, but $filter with $orderby has ordering rules that error, and acc-26 and acc-27 show sender filters failing and base64 truncated through an MCP wrapper. source |
| Unipile B UNIPILE SAS | List emails returns up to 250 a page with body_plain and attachment metadata, filtered by from, to, dates and folder, but Microsoft rejects search combined with other filters, IMAP search covers one folder at day granularity, and attachment content is a separate call each. source |
| Zoho Mail API D Zoho Corporation Private Limited | messages/search takes a searchKey in Zoho search syntax with up to 200 results, but returns summaries only, so each body needs a content call with folderId and messageId and each attachment its own call, and by default omits mail from the last 2 minutes. source |
Couldn't check 1
The docs were closed to us, or silent. These carry no mark either way.
| Listing | Why |
|---|---|
| CloudPost F CloudPost (James Brooks) | No public docs or tool schemas; the site is a client-rendered app whose copy says only 'search, read and organise your mail'. Body format, attachment handling and paging can't be read. |
What stops agents finishing
- search filters that error or are silently ignored
- attachment bytes truncated or only downloadable to disk
- bodies only as snippets on some providers
Around it
Before: chat.user-request. After: document-extraction.invoice-fields, spreadsheets.append-rows, accounting.match-transaction.
Where this comes from
Weight 27 of 100 in Mailbox access: 10 of 36 counted mentions (acc-04, 09, 10, 18, 19, 20, 24, 26, 27, 33); the job most issues describe
The same as data: /api/v1/use-cases/mailbox-access.find-and-read.json, or the MCP tool get_use_case with id mailbox-access.find-and-read. Other jobs in this category: /api/v1/niches?category=mailbox-access.
For companies
Do agents find, use and choose your tools?
An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.