How to Read Email Threads

Read the content of individual emails or view entire conversation threads grouped together.

Read a Specific Email#

Once you have an email ID (from a search or listing), read its full content:

“Read that email from Sarah”

tool: read-email
params:
  id: "AAMkAGR..."

The response includes the subject, sender, recipients, date, and body content.

Control How Much Detail You See#

Level	What you get
minimal	Subject, sender, date — no body
standard	Subject, sender, date, body up to 2,000 characters (default)
full	Everything — IDs, all recipients, body up to 40,000 characters

A cut body ends with a note naming the call that gets the rest: read-email with outputVerbosity: full, or for a body over 40,000 characters, export with target: "message", which writes the whole message to a file.

tool: read-email
params:
  id: "AAMkAGR..."
  outputVerbosity: "full"

Browse Conversation Threads#

To see your inbox grouped by conversation instead of individual messages:

“Show me my recent email threads”

tool: search-emails
params:
  groupByConversation: true

This returns one entry per conversation thread, showing the most recent message in each.

Read an Entire Thread#

Once you have a conversation ID, get all messages in the thread:

“Show me the full thread for that conversation”

tool: search-emails
params:
  conversationId: "AAQkAGR..."

Messages are returned in chronological order (oldest first) so you can follow the discussion. Up to 100 messages are returned; a longer thread ends with a “Conversation truncated at 100 messages” note, so export it with export target: "conversation" (up to 1000 messages) to get the rest.

Include Headers with Email Content#

To see basic email headers alongside the body:

tool: read-email
params:
  id: "AAMkAGR..."
  includeHeaders: true

For forensic header analysis (DKIM, SPF, delivery chain), see Investigate Email Headers.

Tips#

• Search first with search-emails, then read with read-email using the returned ID
• Use groupByConversation: true to get a bird’s-eye view of your inbox threads
• Use outputVerbosity: "minimal" when you’re scanning multiple emails and only need subject lines
• For a message or thread from a shared mailbox, pass the same sharedMailbox (alias email) to read-email and search-emails that you found it with, or the ID won’t be found — see Access Shared Mailboxes

Related#

• Find Emails — search to find the email you want to read
• Investigate Email Headers — forensic header analysis
• Export Emails — save emails to files
• Tools Reference — read-email