get-email-content
Retrieve the full content of an email by its unique ID using ClaudePost's email management interface, enabling efficient access to specific email details directly.
Instructions
Get the full content of a specific email by its ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | The ID of the email to retrieve |
Implementation Reference
- src/email_client/server.py:391-421 (handler)Main handler logic for the 'get-email-content' tool within the handle_call_tool function. Extracts email_id, fetches the email content asynchronously, formats it, and returns as text content.elif name == "get-email-content": email_id = arguments.get("email_id") if not email_id: return [types.TextContent( type="text", text="Email ID is required." )] try: async with asyncio.timeout(SEARCH_TIMEOUT): email_content = await get_email_content_async(mail, email_id) result_text = ( f"From: {email_content['from']}\n" f"To: {email_content['to']}\n" f"Date: {email_content['date']}\n" f"Subject: {email_content['subject']}\n" f"\nContent:\n{email_content['content']}" ) return [types.TextContent( type="text", text=result_text )] except asyncio.TimeoutError: return [types.TextContent( type="text", text="Operation timed out while fetching email content." )]
- src/email_client/server.py:204-213 (schema)JSON Schema defining the input parameters for the 'get-email-content' tool, requiring 'email_id' as a string.inputSchema={ "type": "object", "properties": { "email_id": { "type": "string", "description": "The ID of the email to retrieve", }, }, "required": ["email_id"], },
- src/email_client/server.py:201-214 (registration)Registration of the 'get-email-content' tool in the list_tools handler using types.Tool, including name, description, and input schema.types.Tool( name="get-email-content", description="Get the full content of a specific email by its ID", inputSchema={ "type": "object", "properties": { "email_id": { "type": "string", "description": "The ID of the email to retrieve", }, }, "required": ["email_id"], }, ),
- src/email_client/server.py:98-105 (helper)Helper function to asynchronously fetch the full email content (RFC822) using IMAP for a given email_id and format it.async def get_email_content_async(mail: imaplib.IMAP4_SSL, email_id: str) -> dict: """Asynchronously get full content of a specific email.""" loop = asyncio.get_event_loop() try: _, msg_data = await loop.run_in_executor(None, lambda: mail.fetch(email_id, '(RFC822)')) return format_email_content(msg_data) except Exception as e: raise Exception(f"Error fetching email content: {str(e)}")
- src/email_client/server.py:53-79 (helper)Helper function to parse email bytes into a dictionary with headers (from, to, date, subject) and body content, handling multipart and plain emails.def format_email_content(msg_data: tuple) -> dict: """Format an email message into a dict with full content.""" email_body = email.message_from_bytes(msg_data[0][1]) # Extract body content body = "" if email_body.is_multipart(): # Handle multipart messages for part in email_body.walk(): if part.get_content_type() == "text/plain": body = part.get_payload(decode=True).decode() break elif part.get_content_type() == "text/html": # If no plain text found, use HTML content if not body: body = part.get_payload(decode=True).decode() else: # Handle non-multipart messages body = email_body.get_payload(decode=True).decode() return { "from": email_body.get("From", "Unknown"), "to": email_body.get("To", "Unknown"), "date": email_body.get("Date", "Unknown"), "subject": email_body.get("Subject", "No Subject"), "content": body }