email

Get email

getEmail

Read-onlyIdempotent

Use this when you need to read one inbound email. Returns id, thread_id, received_at, from, to, subject, preheader, body_text and each attachment's filename, content type, size and part_index (read one with getEmailAttachment). body_text is the words of the email in reading order, without hidden content or the quoted history below a reply (counted in quoted_chars_removed). Each link is a [n] marker beside its label, with its target left out: link_count says how many there are, and the links argument returns targets. A long body comes in pages: body_chars is its whole length, and when body_next_offset is not null, call again with offset set to it. A parse_status of pending or processing means the email is still being processed, and failed that it could not be parsed: its body and attachments may then be incomplete, so for pending or processing read it again shortly. Pass full: true for the stored record: parsed bodies including HTML, threading metadata, SMTP envelope, authentication results, webhook state, and replies.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	Inbound email ID from listEmails or searchEmails.
`full`	No	Set true for the record as stored. By default the result is a compact view for reading, which leaves out the HTML body, link targets, quoted history, authentication results, routing and webhook delivery state.
`links`	No	Which link targets to return, as a links array of { n, url }: "all", or a comma-separated list of [n] numbers such as "3,7" (at most 50). Omit for none. Not used with full.
`offset`	No	Character position in the body to start from: the body_next_offset of the previous result. Not used with full.
`api_key`	No	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omit it when the user is signed in.
`max_chars`	No	Most characters of body_text to return, 500 to 100000. Read the rest with offset. Not used with full.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	Yes
`tool`	Yes
`status`	Yes
`statusText`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedOct 8, 2026

addedInput schema / properties / full

Added value: +{
+  "default": false,
+  "description": "Set true for the record as stored. By default the result is a compact view for reading, which leaves out the HTML body, link targets, quoted history, authentication results, routing and webhook delivery state.",
+  "type": "boolean"
+}

addedInput schema / properties / links

Added value: +{
+  "description": "Which link targets to return, as a links array of { n, url }: \"all\", or a comma-separated list of [n] numbers such as \"3,7\" (at most 50). Omit for none. Not used with full.",
+  "type": "string"
+}

addedInput schema / properties / max_chars

Added value: +{
+  "default": 16000,
+  "description": "Most characters of body_text to return, 500 to 100000. Read the rest with offset. Not used with full.",
+  "maximum": 100000,
+  "minimum": 500,
+  "type": "integer"
+}

addedInput schema / properties / offset

Added value: +{
+  "default": 0,
+  "description": "Character position in the body to start from: the body_next_offset of the previous result. Not used with full.",
+  "minimum": 0,
+  "type": "integer"
+}

Changed1 schema field changedAug 13, 2026

addedInput schema / properties / api_key

Added value: +{
+  "description": "Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omit it when the user is signed in.",
+  "maxLength": 200,
+  "minLength": 8,
+  "type": "string"
+}

Changed1 schema field changedJun 21, 2026
- addedInput schema / properties / id / description
```
Added value: +"Inbound email ID from listEmails or searchEmails."
```
First observedJun 9, 2026

TDQS

Score is being calculated.

All email tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?