{"_id":"@aftabshaikh4643/email-mcp-server","_rev":"2-6090884784461d644f68927713d66fc7","name":"@aftabshaikh4643/email-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aftabshaikh4643/email-mcp-server","version":"1.0.0","keywords":["mcp","email","gmail","outlook","yahoo","mcp","email","gmail","outlook","yahoo","zoho","imap","smtp","automation","ai","claude","cursor","cold-email","model-context-protocol"],"author":{"name":"Aftab Shaikh"},"license":"MIT","_id":"@aftabshaikh4643/email-mcp-server@1.0.0","maintainers":[{"name":"aftabshaikh4643","email":"aftabshaikh4643@gmail.com"}],"bin":{"email-mcp":"build/index.js"},"dist":{"shasum":"5a2e14c27f17dddc5b04dd08211cbebf31b2281e","tarball":"https://registry.npmjs.org/@aftabshaikh4643/email-mcp-server/-/email-mcp-server-1.0.0.tgz","fileCount":27,"integrity":"sha512-Z/fjmNv79JBpUQoYnmDGBhLdmAiwJB6S1hI+pR200vSHFJhu5Jmv1FWWeDs1NA+LQZLPMHQGqxLwy7hDMeyHig==","signatures":[{"sig":"MEUCIAMI8gbWHNByTJeNMPSqK6XSw38/PXzuQ4lSgCUGQuTTAiEAnVYLCCvU9AGNVpf+RKBs5dk40RbD5yZYx9S7PuMQxsA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137769},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"881ffd58c2f21825a12506c757e18553bb42fe0b","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","build":"tsc","start":"node build/index.js"},"_npmUser":{"name":"aftabshaikh4643","email":"aftabshaikh4643@gmail.com"},"_npmVersion":"11.9.0","description":"Universal Email MCP Server — works with Gmail, Outlook, Yahoo, Zoho, and any IMAP provider. Read, send, reply, draft, manage, cold email, auto-triage, cleanup, follow-ups.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.25.23","imapflow":"^1.4.7","mailparser":"^3.9.14","nodemailer":"^9.0.3","@modelcontextprotocol/sdk":"^1.12.3"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","typescript":"^5.8.3","@types/node":"^24.0.4","@types/mailparser":"^3.4.6","@types/nodemailer":"^8.0.1"},"_npmOperationalInternal":{"tmp":"tmp/email-mcp-server_1.0.0_1784260717356_0.6515796111293124","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aftabshaikh4643/email-mcp-server","version":"1.0.1","description":"Universal Email MCP Server — works with Gmail, Outlook, Yahoo, Zoho, and any IMAP provider. Read, send, reply, draft, manage, cold email, auto-triage, cleanup, follow-ups.","main":"build/index.js","type":"module","bin":{"email-mcp":"build/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node build/index.js","lint":"tsc --noEmit"},"keywords":["mcp","email","gmail","outlook","yahoo","mcp","email","gmail","outlook","yahoo","zoho","imap","smtp","automation","ai","claude","cursor","cold-email","model-context-protocol"],"author":{"name":"Aftab Shaikh"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.3","imapflow":"^1.4.7","mailparser":"^3.9.14","nodemailer":"^9.0.3","zod":"^3.25.23"},"devDependencies":{"@types/mailparser":"^3.4.6","@types/node":"^24.0.4","@types/nodemailer":"^8.0.1","tsx":"^4.19.4","typescript":"^5.8.3"},"engines":{"node":">=18.0.0"},"gitHead":"41decfc28f0ecb9d4c4972d28df3a17f3b052df0","types":"./build/index.d.ts","_id":"@aftabshaikh4643/email-mcp-server@1.0.1","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-AX+CNOli3VD1K56Ddhoh+f/giEno1Qot4EmMRH3lE1U1XIJWlUsCHtC5aTVBQIN2VvjIGPDobFCxwe0SEf0d0g==","shasum":"4d85358536112d26eaf9e1f56ee215fff79a795f","tarball":"https://registry.npmjs.org/@aftabshaikh4643/email-mcp-server/-/email-mcp-server-1.0.1.tgz","fileCount":27,"unpackedSize":139764,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDHtljUDJ5iq8K6AJAscQoCZYTRm3V8pYWgrFzc+FnIYwIhALzbHp56LhC9fSwfk3PCj8VQ6pFbUWRSGN9HsDC8pmaf"}]},"_npmUser":{"name":"aftabshaikh4643","email":"aftabshaikh4643@gmail.com"},"directories":{},"maintainers":[{"name":"aftabshaikh4643","email":"aftabshaikh4643@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/email-mcp-server_1.0.1_1784262256169_0.6509407146688642"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-17T03:58:37.206Z","modified":"2026-07-17T04:24:16.426Z","1.0.0":"2026-07-17T03:58:37.491Z","1.0.1":"2026-07-17T04:24:16.291Z"},"author":{"name":"Aftab Shaikh"},"license":"MIT","keywords":["mcp","email","gmail","outlook","yahoo","mcp","email","gmail","outlook","yahoo","zoho","imap","smtp","automation","ai","claude","cursor","cold-email","model-context-protocol"],"description":"Universal Email MCP Server — works with Gmail, Outlook, Yahoo, Zoho, and any IMAP provider. Read, send, reply, draft, manage, cold email, auto-triage, cleanup, follow-ups.","maintainers":[{"name":"aftabshaikh4643","email":"aftabshaikh4643@gmail.com"}],"readme":"# Email MCP Server\n\n**Universal email integration for AI assistants.** Works with Gmail, Outlook, Yahoo, Zoho, iCloud, AOL, and any IMAP email provider.\n\nRead, send, reply, draft, manage, clean up, run cold email campaigns, auto-triage, and track follow-ups — all through the Model Context Protocol.\n\nCompatible with **Claude Desktop**, **Cursor**, **Hermes Agent**, **Windsurf**, and any MCP client.\n\n---\n\n## Why This Exists\n\nEvery email MCP out there only works with Gmail via Google Cloud OAuth. This one:\n\n- **Works with ANY email provider** — Gmail, Outlook, Yahoo, Zoho, iCloud, AOL, custom domains\n- **No Google Cloud project needed** — uses IMAP + App Passwords (free, 30 seconds)\n- **18 tools** — full email management + AI-powered automation\n- **Zero data leaves your machine** — everything runs locally\n\n---\n\n## Supported Providers (Auto-Detected)\n\n| Provider | IMAP | SMTP |\n|----------|------|------|\n| Gmail / Google Workspace | imap.gmail.com:993 | smtp.gmail.com:465 |\n| Outlook / Hotmail / Live | outlook.office365.com:993 | smtp.office365.com:587 |\n| Yahoo Mail | imap.mail.yahoo.com:993 | smtp.mail.yahoo.com:465 |\n| Zoho Mail (.com, .in, .eu, .com.au, .jp) | imap.zoho.com:993 | smtp.zoho.com:465 |\n| iCloud / Me.com | imap.mail.me.com:993 | smtp.mail.me.com:587 |\n| AOL Mail | imap.aol.com:993 | smtp.aol.com:465 |\n| **Any custom IMAP** | Set `IMAP_HOST` env var | Set `SMTP_HOST` env var |\n\nJust enter your email — the server auto-detects the provider.\n\n---\n\n## 18 Tools\n\n### Read (5)\n| Tool | Description |\n|------|-------------|\n| `email_search` | Search emails with query syntax |\n| `email_read` | Read full email by ID |\n| `email_read_thread` | Read entire conversation |\n| `email_inbox` | Quick inbox view (unread filter) |\n| `email_profile` | Account info |\n\n### Send (5)\n| Tool | Description |\n|------|-------------|\n| `email_send` | Send email (HTML, CC, BCC, threading) |\n| `email_reply` | Reply to email (auto-sets headers) |\n| `email_draft` | Create draft |\n| `email_send_draft` | Send existing draft |\n| `email_list_drafts` | List all drafts |\n\n### Manage (8)\n| Tool | Description |\n|------|-------------|\n| `email_labels` | List all folders/labels |\n| `email_create_label` | Create new folder |\n| `email_archive` | Archive messages |\n| `email_trash` | Move to trash |\n| `email_delete` | Permanent delete |\n| `email_mark_read` / `email_mark_unread` | Toggle read status |\n| `email_star` / `email_unstar` | Toggle star/flag |\n| `email_add_label` / `email_remove_label` | Move between folders |\n\n### Automation (7) — The Premium Features\n| Tool | Description |\n|------|-------------|\n| `email_digest` | Morning summary grouped by sender |\n| `email_suggest_reply` | Prepare AI reply context |\n| `email_triage` | Classify unread by priority |\n| `email_cleanup` | Archive old/newsletter/social (dry-run) |\n| `email_cold_campaign` | Personalized bulk emails with placeholders |\n| `email_follow_up` | Find sent emails with no reply |\n| `email_contacts` | Extract contacts from email history |\n\n---\n\n## Quick Start\n\n### 1. Generate an App Password\n\n**Gmail:**\n1. Go to https://myaccount.google.com/apppasswords\n2. Select app → Generate → Copy the 16-char password\n\n**Outlook/Hotmail:**\n1. Go to https://account.live.com/proofs/AppPassword\n2. Create new app password → Copy\n\n**Yahoo:**\n1. Go to https://login.yahoo.com/account/security\n2. Generate app password for \"Mail\"\n\n**Zoho:**\n1. Go to https://accounts.zoho.com/home#security/app-passwords\n2. Generate new app password → Copy\n\n### 2. Install & Run\n\n```bash\ncd email-mcp-server\nnpm install\nnpm run build\n\n# Set credentials\nexport EMAIL_ADDRESS=\"you@example.com\"\nexport EMAIL_PASSWORD=\"your-app-password\"\n\n# Run\nnode build/index.js\n```\n\n### 3. Connect to Your AI\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"email\": {\n      \"command\": \"node\",\n      \"args\": [\"C:/path/to/email-mcp-server/build/index.js\"],\n      \"env\": {\n        \"EMAIL_ADDRESS\": \"you@example.com\",\n        \"EMAIL_PASSWORD\": \"your-app-password\"\n      }\n    }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`): Same structure as above.\n\n**Hermes Agent:**\n```bash\nhermes mcp add email --command node --args C:/path/to/email-mcp-server/build/index.js\n```\n\n---\n\n## Usage Examples\n\n> \"Check my inbox and summarize the important emails\"\n> \"Read the email from john@company.com and draft a reply\"\n> \"Clean up my inbox — archive all newsletters older than 7 days\"\n> \"Send cold emails to these 5 prospects about web development\"\n> \"Show me emails I sent that haven't gotten a reply\"\n> \"Triage my unread emails by priority\"\n\n---\n\n## Cold Email Campaign\n\n```json\n{\n  \"recipients\": [\n    { \"email\": \"john@acme.com\", \"name\": \"John\", \"company\": \"Acme Corp\" },\n    { \"email\": \"sarah@startup.io\", \"name\": \"Sarah\", \"company\": \"StartupIO\" }\n  ],\n  \"subject_template\": \"Quick question about {{company}}'s tech stack\",\n  \"body_template\": \"<p>Hi {{name}},</p><p>I noticed {{company}} is growing fast...</p>\",\n  \"create_drafts\": true\n}\n```\n\nAlways use `create_drafts: true` first to review before sending.\n\n---\n\n## Custom IMAP/SMTP\n\nFor providers not in the auto-detect list:\n\n```bash\nexport IMAP_HOST=\"mail.yourprovider.com\"\nexport IMAP_PORT=\"993\"\nexport SMTP_HOST=\"smtp.yourprovider.com\"\nexport SMTP_PORT=\"465\"\n```\n\n---\n\n## Security\n\n- Credentials in environment variables only (never written to disk)\n- All processing local — no external API calls\n- App Passwords revocable anytime from provider settings\n\n---\n\n## License\n\nMIT — Use freely, modify, sell as part of your services.\n","readmeFilename":"README.md"}