get-email-content
Retrieve complete email content using the email ID. This tool enables users to access and read full email messages from Gmail and other providers through ClaudePost's email management system.
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)Dispatches the 'get-email-content' tool call: validates email_id, fetches content asynchronously, handles timeout, and returns formatted 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:201-214 (registration)Registers the 'get-email-content' tool with the MCP server, defining its name, description, and JSON schema requiring 'email_id'.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-106 (helper)Asynchronous helper function that fetches the raw email message data using IMAP and delegates formatting to format_email_content.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 raw email bytes into a structured dictionary, extracting headers and preferring plain text body or falling back to HTML.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 }