Naver Mail MCP Server

Instructions

Implementation Reference

• service/mail_service.py:115-120 (handler)

  The core logic for marking mails as read using IMAP flag '\Seen'.

  def mark_as_read(self, mail_uids: List[str]) -> None:
      """
      메일을 읽음 상태로 변경합니다.
      """
      with self._get_mailbox_client() as mailbox:
          mailbox.flag(mail_uids, '\\Seen', True)

• server.py:209-220 (registration)

  The registration of the 'mark_mails_read' tool with its schema in server.py.

  Tool(
      name="mark_mails_read",
      description="메일을 읽음 상태로 변경",
      inputSchema={
          "type": "object",
          "properties": {
              "mail_uids": {
                  "type": "array",
                  "items": {"type": "string"},
                  "description": "읽음 처리할 메일들의 UID 목록"
              }
          },

• server.py:457-464 (handler)

  The tool execution logic in the server's call handler that triggers the service method.

  elif name == "mark_mails_read":
      mail_uids = args.get("mail_uids", [])
  
      if not mail_uids:
          return [TextContent(type="text", text="읽음 처리할 메일 UID 목록이 필요합니다.")]
  
      mail_service.mark_as_read(mail_uids)
      return [TextContent(type="text", text=f"{len(mail_uids)}개의 메일이 읽음 상태로 변경되었습니다.")]