MagicMail

Imap List Folders

List all available IMAP folders/mailboxes in the email account. Returns clean folder names (without namespace prefixes like 'INBOX.') for easy use by AI agents. Use this tool to: 1) See what folders exist before moving emails, 2) Discover folder structure, 3) Find specific folders like INBOX, Sent, Trash, Archive, etc. This is typically the first step when working with email folders. Folder names returned can be used directly in other IMAP tools.

Imap Select Folder

Select/change to a specific IMAP folder to work with its messages. Use this tool to: 1) Switch to a different folder before reading messages, 2) Access folders like INBOX, Sent, Drafts, Archive, etc. 3) Prepare for message operations in a specific folder. Note: Most other tools automatically select folders, so this is mainly for explicit folder switching.

Imap Get Headers

Retrieve email headers (subject, from, to, date, message-id) of messages in a folder WITHOUT downloading full message content. BEST TOOL FOR COUNTING EMAILS: Returns 'total_messages' field with exact count of emails in folder. Use this tool to: 1) COUNT emails in a folder (set limit=1 for efficiency), 2) Quickly browse emails in a folder, 3) Find specific emails by subject/sender, 4) Get message UIDs for further operations, 5) Preview folder contents efficiently. Much faster than getting full me

Imap Get Messages

Retrieve complete email messages including headers AND body content from a folder. Use this tool to: 1) Read full email content, 2) Get message bodies for analysis, 3) Access attachments info, 4) Download complete conversations. Note: Slower than headers-only, use when you need full message content.

Imap Get Message By Uid

Retrieve a specific email message by its unique UID (Unique Identifier). Use this tool to: 1) Get a specific email when you know its UID from headers, 2) Read a particular message for detailed analysis, 3) Access specific emails for moving/deleting operations. UIDs are obtained from imap_get_headers.

Imap Delete Message

Delete an email message. BEHAVIOR: 1) From regular folders (INBOX, Sent, etc.) - MOVES message to Trash folder (safe deletion), 2) From Trash folder - PERMANENTLY DELETES message (purges from server). Use this tool to: 1) Delete unwanted emails, 2) Clean up inbox, 3) Remove spam/junk messages, 4) Permanently purge emails from Trash. Messages deleted from Trash are PERMANENTLY REMOVED and cannot be recovered.

Imap Move Message

Move an email message from one folder to another folder (e.g., INBOX to Archive, Sent to Archive, etc.). Use this tool to: 1) MOVE EMAILS TO DIFFERENT FOLDERS, 2) Organize emails into Archive/Projects/etc., 3) Move emails between INBOX/Sent/Drafts, 4) Relocate messages for better organization. This is the PRIMARY tool for moving emails between folders.

Imap Manage Folders

FOLDER MANAGEMENT TOOL: Create new email folders, rename existing folders, or delete folders. PRIMARY USES: 1) CREATE NEW FOLDERS - Make new folders like 'Projects', 'Archive_2024', 'Important' for email organization, 2) RENAME FOLDERS - Change folder names to better organize emails, 3) DELETE FOLDERS - Remove unused/empty folders. Use action='create' to CREATE NEW FOLDERS, action='rename' to rename, action='delete' to remove. Essential for setting up email folder structure.

Imap Create Folder

CREATE NEW EMAIL FOLDERS for organization. Use this tool specifically to CREATE NEW FOLDERS in your email account. Perfect for: 1) Creating 'Archive' folders, 2) Making 'Projects' folders, 3) Setting up 'Important' folders, 4) Creating year-based folders like 'Archive_2024', 5) Organizing emails into custom categories. This is the DEDICATED TOOL for creating new email folders.