IMAP MCP Pro

Remove an entry from a per-user allow or deny list (matches the normalized value).

Rename a folder/mailbox in an IMAP account

Reply to an existing email

Manually reset the circuit breaker for an account back to CLOSED with zero failure count. Use when the breaker has tripped due to transient errors and you don't want to wait for the timeout-based HALF_OPEN transition. Returns the breaker's previous state for diagnostics.

Reset connection metrics for an account

Reset SMTP metrics for an account (or all accounts if omitted).

Manage cached MCP tool results (resource-handle pattern). Use action='get' to page through a stored result, action='list' to see what's cached, action='delete' to remove one, action='persist' to keep a temp result for future sessions.

Scan entire IMAP account for spam using UserCheck, checking all folders

Start a resumable account-wide spam scan (UserCheck) as a tracked job. Scans every folder, dedupes senders to unique addresses, and checks each once (cached senders cost no API call). Returns the full summary if it completes within ~30s, otherwise a jobId to poll/resume/cancel. Unlike imap_scan_account_spam this has no 1000-sender cap and survives interruption.

Extract and validate all domains from an email message against DNS firewall

Scan a block of messages for spam with up to three independently-toggleable engines and the per-user allow/deny lists. checkSender = UserCheck sender reputation; checkDomains = DNS firewall over all domains; checkLinks = LinkCheck over every embedded URL (flags DNS-blocked link domains, URL shorteners, and raw-IP hosts). Allowlisted senders are never flagged; denylisted always. Optional action moves flagged messages to a Junk folder (safe/reversible) or flags them — it never sets \Deleted.

Analyze email headers to detect spoofing and calculate confidence score (-100 to +100). Returns detailed breakdown of scoring rules, flags, and recommendation.

Fast SQL-backed search against the local header cache. Modes: by_domain (rows where from_domain matches), by_address (exact from_address match), group_by_sender (top-N senders by message count), fulltext (FTS5 ranked search over subject + sender name/address — for partial-recall queries; no message bodies are searched). Returns an explicit cache_miss error for a folder that has not been synced (see imap_sync_folder_cache).

Search for emails in a folder. Default limit is 50. Inline mode (default for small results) caps at 100 to prevent token overflow; set responseMode='handle' or 'file' to return a resultId for larger sets (up to 10,000). Handle results are paged through imap_results (action='get').

Send an email via SMTP and (by default) append the message to the IMAP Sent folder. Sent folder resolution: cache → SPECIAL-USE \Sent flag → provider preset → fallback name probe. Gmail accounts skip the APPEND by default because Gmail server-copies sent messages; pass forceAppendToSent=true to override. Bcc is preserved in the Sent copy per RFC 5322 §3.6.3. Attachment input — pick one form per file: (1) `attachments` (inline base64) when the file lives in a sandbox the server cannot read (Claude Desktop Workspace, Claude.ai code sandbox, remote host); (2) `attachmentPaths` when the file is on the same host as this server and inside the configured allow-list; (3) `stagedAttachmentIds` only for files > ~10 MB that need chunked upload.

Reset the server's runtime state without restarting Claude Desktop: close pooled IMAP and SMTP connections and clear the in-memory IMAP capabilities cache. Connections reconnect lazily on the next operation — useful after changing account settings on the server, or when connections have gone stale. NOTE: this does NOT reload configuration, environment variables, or the tool list, and never touches the database or stored data; picking up config/env changes or a server upgrade still requires a full restart.

Set the per-account email signature appended to outgoing messages (plain text and/or HTML). Pass clear:true to remove the signature. The signature is added after the body under the standard "-- " delimiter; imap_send_email includeSignature:false suppresses it for a single send.

Set the priority (high / normal / low) of one or more messages. Because IMAP messages are immutable, this is stored as a custom IMAP keyword ($Priority-High / $Priority-Low) via STORE, not by rewriting the X-Priority header; "normal" clears the keyword. Some servers may not allow custom keywords — the result reports whether the server accepted it. Real priority headers on outgoing mail are set by imap_send_email.

Share an account with another user (MSP feature)

Subscribe to a mailbox (RFC 9051 SUBSCRIBE command)

Populate the local message header cache for one folder. Idempotent: subsequent calls only fetch new UIDs since the last sync. Returns row counts + duration. UIDVALIDITY change triggers a full resync. imap_search_cache returns results only for folders that have been synced here.

Test an existing account's IMAP connectivity using its stored credentials. Spawns a one-shot connection that does not affect the persistent connection pool or circuit breaker state. Returns folder count and INBOX message count on success, or a structured error (TLS / auth / DNS / timeout) on failure with a duration in ms. Useful immediately after imap_add_account_with_provider or imap_add_account_auto to verify credentials before relying on the account.

Dry-run the Quick Categories against a folder WITHOUT moving any email: reports coverage (% that would be categorized), per-category counts + destination, which keyword triggered each match, emails matching multiple categories (conflicts), and the uncategorized set. Helps tune keywords ahead of imap_apply_categories.

Verify Quad9 DNS threat-blocking is active. Resolves a clean control domain (should resolve) and a blocked-test domain (should be NXDOMAIN/empty when filtering is on) via Quad9 DNS-over-HTTPS, then reports a derived pass/fail. There is no standardized public Quad9 "blocked" test host, so pass a blockedTestDomain you know Quad9 blocks for a definitive result.

Diagnose Sent folder resolution for an account. Returns the resolved folder name, the resolution method (cache, special_use, preset, fallback, auto_created, failed), whether the cache was hit, and whether the account would skip APPEND under default settings (Gmail server-copy behavior).

Probe SMTP connectivity for an account without sending. Returns TLS version & cipher, certificate validity & expiry, server greeting, EHLO capabilities, AUTH methods, RTT, auth pass/fail, and provider-aware guidance for known auth-failure patterns (Gmail app passwords, Outlook app passwords, etc.). Use 'verbose' to include the raw SMTP transcript.

Revoke account access from a user

Unsubscribe from a mailbox (RFC 9051 UNSUBSCRIBE command)

Apply skill updates from public GitHub for explicitly named skills. Fetches SKILL.md + version.json from raw.githubusercontent.com, writes to ~/.claude/skills/imap-mcp-pro/{name}/, preserves files when the on-disk version is already at or ahead of remote unless force=true. Skills not present in the bundled manifest are rejected (the manifest is the allowlist). imap_check_skill_updates reports what would change before any update is applied.

Update the category of a subscription (marketing, newsletter, promotional, transactional, other). Helps organize subscriptions.

Add or update notes for a subscription. Useful for tracking why you subscribed, unsubscribe difficulty, etc.