create_folder
Create a new email folder to organize messages by specifying a folder name. This tool helps users manage email structure within their email accounts.
Instructions
Create a new email folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_name | Yes | Name of the folder to create |
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))]