Mail MCP Server

Instructions

Implementation Reference

• src/mail_mcp/folders/manager.py:241-278 (handler)

  The FolderManager.delete_folder method performs the actual IMAP delete operation on the server.

  def delete_folder(self, name: str) -> bool:
      """
      Delete a folder/mailbox.
  
      Args:
          name: Name of the folder to delete
  
      Returns:
          True if successful
  
      Raises:
          FolderNotFoundError: If folder does not exist
          FolderError: If operation fails
      """
      self._validate_folder_name(name)
  
      try:
          response = self._conn.delete(name)
  
          status = response[0]
          if status not in ("OK", b"OK"):
              error_msg = (
                  response[1][0].decode("utf-8", errors="replace")
                  if response[1]
                  else "Unknown error"
              )
  
              if "does not exist" in error_msg.lower() or "not found" in error_msg.lower():
                  raise FolderNotFoundError(f"Folder '{name}' does not exist")
  
              raise FolderError(f"Failed to delete folder: {error_msg}")
  
          return True
  
      except FolderError:
          raise
      except Exception as e:
          raise FolderError(f"Failed to delete folder: {str(e)}")

• src/mail_mcp/client.py:94-99 (handler)

  The IMAPClient.delete_folder method wraps the IMAP connection call to delete a folder.

  def delete_folder(self, folder_name: str) -> dict[str, Any]:
      """Delete a folder."""
      conn = self._ensure_connected()
      status, data = conn.delete(folder_name)
      self._check_status(status, data, "Failed to delete folder")
      return {"success": True, "folder": folder_name}