IMAP MCP

Establishes secure connections to IMAP servers using configurable host, port, and authentication credentials. Implements connection pooling and session management to maintain persistent IMAP connections across multiple tool invocations, reducing authentication overhead and enabling stateful operations within a single MCP session.

Enumerates all available mailboxes and folders on the connected IMAP server using the LIST command, returning folder names, hierarchy levels, and special folder attributes (e.g., \Drafts, \Sent, \Trash). Supports recursive folder discovery and filtering by folder type or naming patterns.

Executes IMAP SEARCH commands using RFC 3501 query syntax (e.g., SINCE, BEFORE, FROM, TO, SUBJECT, BODY, UNSEEN) to locate emails matching complex criteria. Translates human-readable search parameters into IMAP protocol commands and returns message UIDs for matched emails, enabling efficient server-side filtering without downloading full message bodies.

Retrieves full email messages by UID using IMAP FETCH command, parsing MIME structure to extract headers (From, To, Subject, Date, CC, BCC), plain-text and HTML body content, and attachments. Automatically decodes quoted-printable and base64 encoding, handles multipart messages, and returns structured email objects with normalized field names.

Modifies email flags (\Seen, \Answered, \Flagged, \Deleted, \Draft) using IMAP STORE command, enabling agents to mark emails as read, flag for follow-up, or delete. Supports batch flag operations on multiple messages and returns confirmation of flag state changes.

Constructs and sends email messages via IMAP APPEND command to the Sent folder, or via SMTP if configured. Builds MIME-formatted messages with headers (From, To, CC, BCC, Subject), plain-text and HTML bodies, and attachments. Handles character encoding, attachment MIME type detection, and message ID generation.

Queries IMAP server for mailbox quota information (used/total storage) and message statistics (total count, unread count, size) using GETQUOTA and STATUS commands. Returns structured quota data enabling agents to monitor storage usage and inbox health.

Registers IMAP operations as MCP tools with JSON schema definitions, enabling LLM clients to discover available email capabilities and invoke them with type-checked parameters. Implements MCP protocol for tool listing, parameter validation, and result serialization, allowing seamless integration with Claude, other LLM clients, and MCP-compatible frameworks.