delete_folder
Remove email folders to organize your mailbox by deleting specified folders from the Mail MCP Server.
Instructions
Delete an email folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_name | Yes | Name of the folder to delete |
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}