IMAP MCP Pro

Get comprehensive information about the IMAP MCP Pro service including version, features, and capabilities

Add a new IMAP account with optional SMTP configuration for current user (from MCP_USER_ID environment variable)

Add a new IMAP account by auto-detecting provider from email address (e.g., @gmail.com → Gmail preset)

Add a new IMAP account using a provider preset (auto-fills IMAP/SMTP settings). Available providers are listed by imap_list_providers.

Add a custom keyword to emails. RFC 9051 recommended keywords: $Forwarded, $MDNSent, $Junk, $NotJunk, $Phishing

Add an entry to a per-user allow or deny list. Value may be an email address or a bare/`@`-prefixed domain (e.g. "a@x.com" or "x.com"). Allow entries protect a sender; deny entries flag one. Normalized + deduped.

Add a UserCheck API key for a user (admin or own user only)

Analyze all emails in a folder and provide confidence statistics. Useful for identifying patterns of suspicious emails.

Append a raw RFC822 message to a mailbox (useful for importing emails, saving drafts, or copying messages)

Apply Quick Categories to emails in a folder. Scans emails and moves them to target folders based on keyword matches. Default limit is 100 to prevent token overflow.

Append one chunk to a staging session. Chunks may arrive out-of-order; duplicate chunkIndex is idempotent. Set isFinal=true on the last chunk to auto-finalize and skip an explicit imap_attachment_stage_finalize call.

Discard a staging session and reclaim its disk space.

Concatenate the uploaded chunks in order, compute SHA-256, mark the session ready for use in imap_send_email via stagedAttachmentIds. Required only if no append call set isFinal=true.

Begin a chunked attachment upload. Use only when the file exceeds the ~10 MB inline ceiling of imap_send_email's `attachments` form, or when streaming from a source that cannot fit a single MCP request. For small files in a sandbox (Claude Desktop Workspace, Claude.ai /mnt/user-data/outputs/), prefer the inline `attachments` form on imap_send_email — it is a single tool call, no chunking, no allow-list. Returns a stagingId, server-recommended chunkSizeBytes (default 256 KiB), and an expiresAt timestamp (default 1 hour). Subsequent chunks are sent via imap_attachment_stage_append. Per-user disk quota is enforced — the call fails if the session's expectedSize would exceed it.

Check multiple domains against DNS firewall in bulk

Bulk copy multiple emails to another folder

Bulk delete multiple emails by UIDs. Automatically uses chunked processing for >50 UIDs to prevent timeouts.

Bulk delete emails with chunking for large operations (1000+ messages). Processes in chunks to avoid timeouts and circuit breaker trips. Returns progress summary.

Bulk fetch multiple emails at once. Automatically uses chunked processing for >50 UIDs. Pass responseMode='handle' or 'file' to avoid token-budget truncation on large sets.

Bulk fetch emails with chunking for large operations (1000+ messages). Defaults responseMode='handle' so large fetches don't blow the token budget.

Request cancellation of a running/queued bulk job. The worker stops at its next checkpoint (no half-applied state); already-processed items are kept so the job can be resumed later.

Resume a paused, failed, or cancelled bulk job from where it stopped — only unprocessed items are run (already-checked senders are skipped). Re-derives the work from the job's saved params. Returns the full summary if it finishes within ~30s, else the jobId to keep polling.

Get one bulk job's detail: status, done/total progress, error count, ETA, and last error.

List persistent bulk-operation jobs (long-running scans) with status and progress. Filter by status; scope to a user. Per-job detail is available from imap_bulk_job_status.

Bulk mark multiple emails with standard IMAP flags. Automatically uses chunked processing for >50 UIDs to prevent timeouts.

Bulk mark emails with chunking for large operations (1000+ messages). Processes in chunks to avoid timeouts and circuit breaker trips. Returns progress summary.

Bulk move multiple emails to another folder (copy + delete)

Scan multiple messages for malicious domains and optionally auto-mark as spam

Analyze multiple emails for spoofing detection. Efficiently processes 100+ emails in < 5 seconds using headers-only analysis. Returns confidence scores and flags for all emails.

Check a sender (a plain address, or a full From header with display name) against the user's allow/deny lists. Returns the verdict (allow / deny / null) and what matched. Email matches beat domain matches; allow beats deny at each level.

Check a domain against UserCheck for spam/validity

Check if a domain is blocked by DNS firewall (Quad9 threat intelligence)

Check a single email address against UserCheck for spam

Check multiple email addresses against UserCheck for spam (max 1000)

Start a resumable bulk spam check of a list of email addresses (UserCheck) as a tracked job. Dedupes to unique addresses, one check each (cache-first). Returns the full summary if done within ~30s, else a jobId to poll/resume/cancel.

Check all emails in a folder against UserCheck and return spam messages

Check public GitHub for newer skill versions without changing anything on disk. Compares each skill in the bundled manifest against the latest version.json on GitHub. Returns a per-skill status with installed/bundled/available versions and a hasUpdate flag. Skills are instructions to the LLM — review the diff before applying via imap_update_skills.

Remove ALL entries from a user's allow or deny list. Irreversible.

Connect to an IMAP account

Copy an email to another folder

Create a new folder/mailbox in an IMAP account

Create a new user (MSP multi-tenant support)

Add IMAP account to database (with encryption at rest)

Get decrypted account details

List all IMAP accounts for a user

Remove IMAP account from database

Delete an email (moves to trash or expunges)

Delete a folder/mailbox from an IMAP account

Delete a UserCheck API key

Disconnect from an IMAP account