MCP Email Service

List emails from inbox (supports multi-account). UIDs are scoped to each account—pass account_id for deterministic follow-up actions. Performs live IMAP fetch; failures usually indicate network or credential issues.

Get detailed content of a specific email including body and attachments. Requires IMAP connectivity to download the latest message content.

Mark one or more emails as read or unread. Pass account_id when operating within a single account, or provide email_accounts mapping for mixed-account batches.

Mark a single email as read (account_id optional but recommended to avoid cross-account lookup).

Mark a single email as unread (account_id optional but recommended).

Mark multiple emails as read

Delete one or more emails (move to trash or permanently delete). Provide account_id or email_accounts mapping so each UID can be routed to the right mailbox.

Delete a single email (move to trash or permanently delete). account_id optional but recommended.

Delete multiple emails (move to trash or permanently delete)

Search emails with various criteria across all accounts or specific account. Returned UIDs must be used with the same account; specify account_id for precise targeting.

Send a new email with optional attachments via SMTP. Ensure the account has SMTP server configuration and valid credentials.

Reply to an email (preserves thread). Requires SMTP access for the originating account.

Forward an email to other recipients using SMTP credentials of the selected account.

List all email folders/labels in the account (IMAP). Provide account_id to target a specific mailbox.

Move emails to a different folder. Requires IMAP access; pass account_id (or use per-email mapping in mark/delete first) so UIDs match the correct account.

Flag/star or unflag an email. Runs against the live mailbox—account_id recommended to avoid cross-account lookups.

Extract attachments from an email by downloading them over IMAP. Requires a reachable mailbox and may incur network latency.

Analyze contact frequency and communication patterns using the local sync database. Works only after emails have been synchronized to the cache.

Get communication timeline with a specific contact from the local sync cache (no live IMAP).

List folders with unread counts per configured account. Requires live IMAP connectivity; returns empty list when the mailbox cannot be reached.

Fetch only email headers (From, To, Subject, Date, Message-ID, etc.) without downloading the body. account_id recommended so the UID lookup hits the right mailbox.

Return recent sync activity/health per account based on local cache data.

Test email server connections (IMAP and SMTP) for all configured accounts using stored credentials.

List all configured email accounts

Get MCP Email Service version and git commit

Unified email synchronization tool: start/stop scheduler, force sync, get status, search cache, manage config (action: start|stop|force|status|search|recent|config). Operates on the local sync service and databases.

Get sync health status for all accounts or a specific account based on cached sync metrics (no live IMAP).

Get synchronization history for all accounts or a specific account within specified hours from the local sync logs.

Get IMAP connection pool statistics from the local sync service, including connection reuse rate and active connections (no remote calls).