list_mailboxes
Retrieve all mailbox folders from an IMAP email account to organize and manage email storage efficiently.
Instructions
List all mailbox folders
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pattern | No | Filter pattern (optional) |
Implementation Reference
- src/imap_mcp/imap_client.py:124-135 (handler)Implementation of the 'list_mailboxes' tool in the IMAP client wrapper.
def list_mailboxes(self, pattern: str = "*") -> list[MailboxInfo]: """List all mailbox folders.""" self._ensure_connected() folders = self.client.list_folders(pattern=pattern) return [ MailboxInfo( name=f[2], delimiter=f[1], flags=[str(flag) for flag in f[0]], ) for f in folders ] - src/imap_mcp/server.py:492-493 (registration)Registration/dispatching logic for 'list_mailboxes' in the MCP server implementation.
elif name == "list_mailboxes": return imap_client.list_mailboxes(pattern=args.get("pattern", "*"))