Tool reference

Email MCP Tools Reference

Complete reference for all email MCP tools available through Connect My Email — organized by tier and capability. Use these tools from Claude Desktop, Cursor, Windsurf, or any MCP-compatible client.

For: Developers who want to understand the full CME tool surface before integrating.

Setup

Get connected

01

Connect your inbox

Sign up at connectmyemail.com and connect your inbox to get your MCP URL.

02

Add to your MCP client

Paste your CME MCP URL into Claude Desktop, Cursor, or Windsurf.

03

Tools auto-discovered

Your AI client automatically discovers all available CME tools based on your plan tier.

Available tools

MCP tools

read_emailsRead email body, subject, sender, date by message IDfree
search_emailsSearch inbox with natural language or Gmail/IMAP query syntaxfree
list_labelsList all labels/folders with unread and total countsfree
get_threadFetch full email thread with all repliesfree
list_attachmentsList attachment names and sizes for an emailfree
simulate_cleanupPreview what a bulk cleanup would affect — no changes madepro
sweep_inboxExecute bulk inbox cleanup after simulate confirmationpro
bulk_deleteDelete emails matching criteria — always previews firstpro
bulk_archiveArchive emails matching criteria in bulkpro
apply_labelApply one or more labels to messages or threadspro
move_to_folderMove emails to a specific folder/labelpro
mark_readMark emails as read in bulkpro
draft_replyCreate a draft reply to a message — requires approval before sendingpro
unsubscribeUnsubscribe from a sender using list-unsubscribe headerspro
create_filterCreate a Gmail filter or Outlook rulepro
send_emailSend an email — always requires explicit user confirmationpower
schedule_sendSchedule an email for later deliverypower
Provider support

CME supports 9 email providers via a single MCP URL: Gmail, Outlook, iCloud, Yahoo, Fastmail, ProtonMail, Zoho, AOL, IMAP. Connect multiple inboxes — all accessible from one MCP endpoint.

FAQ

Common questions

Are all tools available on the free tier?

Read and search tools are free. Bulk cleanup, write, and automation tools require Pro ($9/mo) or Power ($25/mo).

Can your AI use these tools autonomously?

Read tools can run autonomously. Write and delete tools always show a simulation preview and require user confirmation.

Is there a rate limit on MCP tool calls?

Free tier has standard rate limits. Pro and Power have higher limits suitable for bulk operations.

Can I call CME tools from code directly?

Yes — CME also exposes a REST API at api.connectmyemail.com for programmatic access without MCP.

Plug your inbox into your AI.

Free tier. No credit card. Connect in under 5 minutes.