IMAP MCP Server

Instructions

Implementation Reference

• src/imap_mcp/imap_client.py:635-643 (handler)

  The core implementation of flag_email, which handles the IMAP flag addition.

  def flag_email(
      self, uids: list[int], flag: str, mailbox: Optional[str] = None
  ) -> bool:
      """Add flag to emails."""
      self._ensure_connected()
      if mailbox:
          self.select_mailbox(mailbox)
      self.client.add_flags(uids, [flag.encode() if isinstance(flag, str) else flag])
      return True

• src/imap_mcp/server.py:257-271 (registration)

  Registration of the flag_email tool in the MCP server.

  make_tool(
      "flag_email",
      "Add flag to emails",
      {
          "uids": {
              "type": "array",
              "items": {"type": "number"},
              "description": "Email UIDs",
          },
          "flag": {"type": "string", "description": "Flag name (e.g., \\Flagged, \\Important)"},
          "mailbox": {"type": "string", "description": "Mailbox name (default: current)"},
      },
      ["uids", "flag"],
  ),
  make_tool(

• src/imap_mcp/server.py:596-601 (handler)

  The tool execution handler in the MCP server that calls the IMAP client method.

  elif name == "flag_email":
      return imap_client.flag_email(
          uids=args["uids"],
          flag=args["flag"],
          mailbox=args.get("mailbox"),
      )