list_mailboxes
Retrieve all mailbox folders from an IMAP email account to organize and manage email storage efficiently.
Instructions
List all mailbox folders
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_mailboxes"
}
}Input 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", "*"))