What it does

This server exposes 47 email tools over IMAP and SMTP, enabling AI assistants to read, search, send, compose, and manage emails across multiple accounts. It includes email scheduling, real-time IMAP IDLE watchers for new messages, calendar extraction from email attachments, email analytics, and AI-powered triage rules. Multi-account operation, label management (provider-aware for Gmail, Outlook, Yahoo, and others), drafts, templates, and webhook alerts are all included. OAuth2 support for Gmail and Microsoft 365 is available but experimental.

Who it's for

Backend engineers integrating email capabilities into AI-driven applications, and teams building assistants that manage customer support, inbox analysis, or delegated email composition. Useful wherever an AI needs full email client behavior — not just send/reply, but scheduling, bulk operations, and multi-account workflows.

Common use cases

Generate and send emails on behalf of a user from Claude or other assistants, with drafts and scheduled send support.
Analyze incoming emails, extract structured data (dates, attachments, calendar events), and generate summaries or suggested responses.
Build AI email triage workflows: categorize, label, or archive messages based on custom rules and model-driven analysis.
Extract calendar invites from email and surface upcoming meetings to the assistant.
Manage multiple email accounts in a single workflow, with provider auto-detection for Gmail, Outlook, Yahoo, iCloud, and others.

Setup pitfalls

Requires Node.js 22 or later; Docker images are available but config must be created on the host first and mounted in.
CI tests are currently failing. Review recent commits and test results before deploying to production.
Reads and writes to the filesystem (~/.config/email-mcp/config.toml for config and potentially local directories for attachment caching). Makes network calls to IMAP/SMTP servers and OAuth2 endpoints — audit firewall rules and credential permissions accordingly.
OAuth2 support is experimental; password-based IMAP/SMTP is the stable authentication path. Credentials are not logged, but the server requires valid account credentials to function.
Attachment downloads are capped at 5 MB with base64 encoding; larger attachments will be skipped.

Tool name

Description

Destructive?

download_attachment

✓ no

list_templates

✓ no

apply_template

✓ no

list_emails

✓ no

get_email

✓ no

get_emails		✓ no
get_email_status		✓ no
search_emails		✓ no
list_labels		✓ no
add_label		✓ no
remove_label⚠		⚠ yes
create_label		✓ no
delete_label⚠		⚠ yes
bulk_action		✓ no
list_accounts		✓ no
extract_contacts		✓ no
get_email_stats		✓ no
schedule_email		✓ no
list_scheduled		✓ no
cancel_scheduled		✓ no
move_email		✓ no
delete_email⚠		⚠ yes
mark_email		✓ no
check_health		✓ no
get_thread		✓ no
list_mailboxes		✓ no
find_email_folder		✓ no
extract_calendar		✓ no
add_to_calendar		✓ no
check_calendar_permissions⚠		⚠ yes
list_calendars		✓ no
list_events		✓ no
list_reminders		✓ no
create_reminder		✓ no
analyze_email_for_scheduling		✓ no
save_draft		✓ no
send_draft		✓ no
create_mailbox		✓ no
rename_mailbox		✓ no
delete_mailbox⚠		⚠ yes
send_email		✓ no
reply_email		✓ no
forward_email		✓ no
get_watcher_status		✓ no
list_presets		✓ no
get_hooks_config		✓ no
check_notification_setup		✓ no
test_notification		✓ no
configure_alerts		✓ no

@diskd-ai/email-mcp

What it does

Who it's for

Common use cases

Setup pitfalls