Mail MCP Server

Instructions

Implementation Reference

• src/mail_mcp/folders/manager.py:201-234 (handler)

  The handler implementation for creating a folder using IMAP connection.

  def create_folder(self, name: str) -> bool:
      """
      Create a new folder/mailbox.
  
      Args:
          name: Name of the folder to create
  
      Returns:
          True if successful
  
      Raises:
          InvalidFolderNameError: If folder name is invalid
          FolderExistsError: If folder already exists
          FolderError: If operation fails
      """
      self._validate_folder_name(name)
  
      try:
          response = self._conn.create(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 "already exists" in error_msg.lower():
                  raise FolderExistsError(f"Folder '{name}' already exists")
  
              raise FolderError(f"Failed to create folder: {error_msg}")
  
          return True

• src/mail_mcp/tools/__init__.py:464-466 (registration)

  Tool registration/invocation for 'create_folder'.

  elif name == "create_folder":
      result = client.create_folder(arguments["folder_name"])
      return [TextContent(type="text", text=str(result))]