IMAP MCP Server

Instructions

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", "*"))