@codefuturist/email-mcp
Email MCP server with IMAP + SMTP support
Versions
@codefuturist/email-mcp0.2.3latest0.2.10.2.00.1.10.1.0@diskd-ai/email-mcp0.3.8latest0.3.70.3.60.3.50.3.4+ show 3 moreshow less
0.3.30.3.20.3.0Tools 42
get_hooks_config Get the current AI hooks configuration including preset, rules, and custom instructions.
get_email_stats Get email statistics and analytics for a mailbox. Shows volume, top senders, daily trends, and read/flagged counts.
schedule_email Schedule an email to be sent at a specific time in the future. The email is queued locally and sent automatically when the time arrives.
list_scheduled List scheduled emails. Shows pending, sent, or all scheduled emails.
cancel_scheduled Cancel a scheduled email. Removes it from the queue and deletes the associated draft.
list_mailboxes List all mailbox folders for an account with unread counts and special-use flags. Use list_accounts first to get the account name.
list_templates List all available email templates. Templates are TOML files in ~/.config/email-mcp/templates/ with {{variable}} placeholders for subject and body.
apply_template Apply an email template with variable substitution. Use action
save_draft Save an email draft to the Drafts folder. Compose over time, then use send_draft to send it. Use list_emails with the Drafts mailbox to see saved drafts.
send_draft Send an existing draft email and remove it from Drafts. The draft is fetched, sent via SMTP, then deleted. Use list_emails with the Drafts mailbox to find draft IDs.
list_labels List available labels for an email account.
add_label Add a label to an email.
remove_label Remove a label from an email. For ProtonMail, this removes the email from the label folder.
create_label Create a new label. For ProtonMail, creates a folder under Labels/.
delete_label Delete a label. For ProtonMail, deletes the label folder.
extract_calendar Extract calendar events (ICS/iCalendar) from an email. Returns structured event data including time, location, attendees, and status.
extract_contacts Extract unique contacts from recent email headers. Returns contacts sorted by frequency (most frequent first). Useful for finding frequent correspondents or building an address book.
move_email Move an email to a different mailbox folder.
check_notification_setup Diagnose desktop notification support on this platform.
delete_email Delete an email. By default moves to Trash. Set permanent=true for permanent deletion (⚠️ irreversible).
mark_email Change email flags — mark as read/unread, flag/unflag. Idempotent: marking an already-read email as read is a no-op.
create_mailbox Create a new mailbox (folder). Use
rename_mailbox Rename an existing mailbox (folder). Use list_mailboxes to see current folder paths.
delete_mailbox ⚠️ DESTRUCTIVE: Permanently delete a mailbox and ALL its contents. This cannot be undone. Use list_mailboxes to verify the folder path.
list_accounts List all configured email accounts. Call this first to discover available account names for use with other tools.
bulk_action Batch operation on multiple emails by UID list. Supports mark_read, mark_unread, flag, unflag, move, and delete. Max 100 IDs per call. Returns success/failure counts.
send_email Send a new email. Supports plain text or HTML body, CC, and BCC.
reply_email Reply to an email with proper threading (In-Reply-To & References headers). Use get_email first to read the original.
forward_email Forward an email to new recipients with optional additional message. Original email is quoted below.
get_thread Reconstruct a full email conversation thread by following References and In-Reply-To headers.
find_email_folder Find which real mailbox folder(s) an email belongs to.
list_emails List emails in a mailbox with optional filters. Returns paginated results with metadata
get_email Get the full content of a specific email by ID.
get_emails Fetch the full content of multiple emails in a single call (max 20).
get_email_status Get the current read/flag/label state of an email without fetching its body.
search_emails Search emails by keyword across subject, sender, and body.
download_attachment Download an email attachment by filename. First use get_email to see available attachments and their filenames. Returns base64-encoded content for files ≤5MB.
get_watcher_status Get the status of IMAP IDLE watcher connections and recent activity.
list_presets List all available AI triage presets with their descriptions and suggested labels.
test_notification Send a test desktop notification to verify that OS permissions are correctly configured.
configure_alerts Update alert/notification settings at runtime. Changes take effect immediately.
check_health Check connection health, quota, and capabilities for email accounts. Useful for diagnosing issues.
Permissions 4
network medium filesystem low shell high env_vars low