delete_mailbox
Remove an existing mailbox (folder) from your iCloud email account by specifying the mailbox name to delete unwanted folders and organize your email storage.
Instructions
Delete an existing mailbox (folder)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the mailbox to delete |
Implementation Reference
- src/index.ts:528-555 (handler)Handler for delete_mailbox tool: validates configuration and input, calls mailClient.deleteMailbox, and formats response.
case 'delete_mailbox': { if (!mailClient) { throw new McpError( ErrorCode.InvalidRequest, 'iCloud Mail not configured. Please set ICLOUD_EMAIL and ICLOUD_APP_PASSWORD environment variables.' ); } const mailboxName = args?.name as string; if (!mailboxName) { throw new McpError( ErrorCode.InvalidParams, 'Mailbox name is required' ); } const result = await mailClient.deleteMailbox(mailboxName); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; } - Core implementation of mailbox deletion using IMAP delBox command, with input validation, system mailbox protection, and enhanced error messages.
async deleteMailbox( name: string ): Promise<{ status: string; message: string }> { if (!name || name.trim() === '') { return { status: 'error', message: 'Mailbox name cannot be empty', }; } const trimmedName = name.trim(); // Prevent deletion of important system mailboxes const systemMailboxes = ['INBOX', 'Sent', 'Trash', 'Drafts', 'Junk']; if (systemMailboxes.includes(trimmedName)) { return { status: 'error', message: `Cannot delete system mailbox '${trimmedName}'`, }; } return new Promise((resolve) => { this.imap.delBox(trimmedName, (err: Error) => { if (err) { let errorMessage = err.message; // Provide more helpful error messages for common issues if (err.message.includes('does not exist')) { errorMessage = `Mailbox '${trimmedName}' does not exist`; } else if (err.message.includes('not empty')) { errorMessage = `Cannot delete mailbox '${trimmedName}' because it contains messages. Please move or delete all messages first.`; } else if (err.message.includes('permission')) { errorMessage = `Permission denied: Cannot delete mailbox '${trimmedName}'`; } resolve({ status: 'error', message: errorMessage, }); return; } resolve({ status: 'success', message: `Mailbox '${trimmedName}' deleted successfully`, }); }); }); } - src/index.ts:160-173 (registration)Registration of the delete_mailbox tool with MCP server, including description and input schema.
{ name: 'delete_mailbox', description: 'Delete an existing mailbox (folder)', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Name of the mailbox to delete', }, }, required: ['name'], }, }, - src/index.ts:163-172 (schema)Input schema definition for delete_mailbox tool.
inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Name of the mailbox to delete', }, }, required: ['name'], },