get-email-content

Instructions

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
      }