Documentation
ConnectMyEmail docs.
Quickstart, MCP setup, providers, REST API, webhooks, limits. Tool reference at /tools.
Quickstart
- 1. Sign in with Google or create an account.
- 2. Connect your inbox with an app password — Gmail, iCloud, Yahoo, Fastmail, or any generic IMAP server. (Outlook coming soon.)
- 3. Copy the connector URL from the dashboard: https://mcp.connectmyemail.com/mcp. It is the same URL for everyone; your sign-in is what links it to your inbox.
- 4. Paste it into Claude (Customize → Connectors → Add custom connector), Cursor, ChatGPT (Plugins → Add custom MCP server), or another supported MCP client. Your client opens a Connect My Email sign-in page. Pick your provider, sign in there, and you're live.
Providers
- Connect from the Inboxes tab in your dashboard with an app password. More sign-in options coming soon.
- Gmail, Google Workspace — app password (enable 2-Step Verification, then create an app password).
- Outlook, Microsoft 365 — coming soon.
- Apple iCloud — app-specific password from appleid.apple.com.
- Yahoo — app password from Yahoo Account Security.
- Fastmail — app password from Settings → Privacy & Security.
- ProtonMail — not available on the hosted service. Proton only allows IMAP through its Bridge app, which has to run on the same machine as the connector.
- Generic IMAP/SMTP — host, port, username, password.
- AOL — app password from AOL Account Security.
MCP setup
- ConnectMyEmail runs as a remote MCP server. Add the connector URL to your client. No middleware, no sandbox account.
- No API key goes in the MCP config. The connector signs you in through its own sign-in page (OAuth), which your client opens the first time it connects. For an agent that runs unattended, send a Pro or Power API key instead: Authorization: Bearer cme_..., plus X-CME-Connection-Id when the account has more than one inbox.
Claude — Customize → Connectors → Add → Add custom connectortext
Name: Connect My Email URL: https://mcp.connectmyemail.com/mcp
Claude Code — Terminalbash
claude mcp add --transport http connect-my-email https://mcp.connectmyemail.com/mcp
Cursor — .cursor/mcp.jsonjson
{
"mcpServers": {
"connect-my-email": {
"url": "https://mcp.connectmyemail.com/mcp"
}
}
}ChatGPT — Plugins → Add → Add custom MCP servertext
Name: Connect My Email URL: https://mcp.connectmyemail.com/mcp Auth: OAuth
REST API
- Base URL: https://mcp.connectmyemail.com/api
- Auth: Bearer token (API key from dashboard → API & integrations; Pro and Power).
- Rate limits: REST tool calls are limited per account by plan (Free 10, Pro 60, Power 300 a minute), and every request per IP address. A 429 response carries a Retry-After header.
Search inboxbash
curl https://mcp.connectmyemail.com/api/search \ -H "Authorization: Bearer cme_********" \ -G --data-urlencode "q=invoice from:stripe"
Recent threadsbash
curl "https://mcp.connectmyemail.com/api/connections/{connection_id}/threads?limit=20" \
-H "Authorization: Bearer cme_********"Run a sweepbash
curl -X POST https://mcp.connectmyemail.com/api/sweep/execute \
-H "Authorization: Bearer cme_********" \
-H "Content-Type: application/json" \
-d '{"sweep_id":"swp_...","dry_run":true}'Webhooks
- Register HTTPS endpoints from the Webhooks tab in your dashboard, on every plan. Every delivery is signed with HMAC-SHA256: the X-CME-Signature header is sha256=<hex> over the X-CME-Timestamp value, a dot, and the raw body.
- Endpoint caps: 1 (Free) · 3 (Pro) · 10 (Power).
- Events: email.received, email.sent, email.flagged, email.deleted, email.moved, sweep.completed, sweep.cleanup_executed, sweep.bulk_archive, sweep.bulk_mark_read, security.block_sender, security.nuke_sender, connection.added, connection.removed, connection.error, quota.warning, quota.reached, follow_up.due, snooze.woke, snooze.failed, schedule_send.failed, send.refused.
- Retries: 3 attempts at 30s / 5min / 30min before the endpoint is marked dead.
Example payload — sweep.completedjson
{
"id": "evt_01HXYZ...",
"type": "sweep.completed",
"created_at": "2026-05-04T08:13:42Z",
"data": {
"run_id": "run_18a2",
"scope": "30days",
"mode": "safe",
"processed_count": 18941,
"archived_count": 12031,
"duration_ms": 47210
}
}Verify signature (Node)bash
import crypto from "node:crypto";
const secret = process.env.CME_WEBHOOK_SECRET;
const sig = req.headers["x-cme-signature"]; // "sha256=<hex>"
const ts = req.headers["x-cme-timestamp"];
const expected = "sha256=" + crypto
.createHmac("sha256", secret)
.update(`${ts}.${req.rawBody}`)
.digest("hex");
// constant-time compare
crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));Limits & quotas
- Cleanup actions / month: 5,000 (Free, guarded + reversible) · 50,000 (Pro) · 150,000 (Power).
- One-click unsubscribes / month: 25 on Free, one sender at a time · unlimited and in bulk on Pro and Power. Each one counts toward cleanup actions.
- Sweep cap per scan: 25k / 250k / 500k.
- Session timeout: 30 min / 8 h / 24 h.
- See /pricing for the full matrix.