Enables sending, searching, replying to, and organizing Gmail emails through SMTP and IMAP protocols, with support for attachments, threading, and folder management.
Enables sending, searching, replying to, and organizing iCloud Mail emails through SMTP and IMAP protocols, with support for attachments, threading, and folder management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Email SMTP/IMAP MCP Server find unread emails from my boss this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A clean, simple stdio MCP server for email operations supporting both SMTP (sending) and IMAP (reading).
✅ Send emails with HTML and attachments
✅ Search emails with flexible filters
✅ Reply/Forward with proper threading
✅ Organize (mark read, archive, flag)
✅ Multi-account support for managing multiple email accounts
✅ List folders to browse your mailbox structure
Related MCP server: Email Send/Receive MCP Server
npx -y email-smtp-imap-mcpOr install globally:
npm install -g email-smtp-imap-mcpAdd to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": ["-y", "email-smtp-imap-mcp"],
"env": {
"EMAIL_ACCOUNTS_JSON": "{\"work\":{\"smtp\":{\"host\":\"smtp.gmail.com\",\"port\":587,\"user\":\"your@gmail.com\",\"password\":\"app-password\"},\"imap\":{\"host\":\"imap.gmail.com\",\"port\":993,\"user\":\"your@gmail.com\",\"password\":\"app-password\"},\"default_from_name\":\"Your Name\",\"sender_emails\":[\"your@gmail.com\"]}}",
"DEFAULT_EMAIL_ACCOUNT": "work"
}
}
}
}⚠️ Important: Restart Claude Desktop after adding this configuration.
"EMAIL_ACCOUNTS_JSON": "{\"gmail\":{\"smtp\":{\"host\":\"smtp.gmail.com\",\"port\":587,\"user\":\"your@gmail.com\",\"password\":\"app-password\"},\"imap\":{\"host\":\"imap.gmail.com\",\"port\":993,\"user\":\"your@gmail.com\",\"password\":\"app-password\"},\"default_from_name\":\"Your Name\",\"sender_emails\":[\"your@gmail.com\"]}}"Setup: Create App Password
"EMAIL_ACCOUNTS_JSON": "{\"icloud\":{\"smtp\":{\"host\":\"smtp.mail.me.com\",\"port\":587,\"user\":\"your@icloud.com\",\"password\":\"app-specific-password\"},\"imap\":{\"host\":\"imap.mail.me.com\",\"port\":993,\"user\":\"your@icloud.com\",\"password\":\"app-specific-password\"},\"default_from_name\":\"Your Name\",\"sender_emails\":[\"your@icloud.com\"]}}"Setup: Generate App-Specific Password
"EMAIL_ACCOUNTS_JSON": "{\"outlook\":{\"smtp\":{\"host\":\"smtp-mail.outlook.com\",\"port\":587,\"user\":\"your@outlook.com\",\"password\":\"your-password\"},\"imap\":{\"host\":\"outlook.office365.com\",\"port\":993,\"user\":\"your@outlook.com\",\"password\":\"your-password\"},\"default_from_name\":\"Your Name\",\"sender_emails\":[\"your@outlook.com\"]}}""EMAIL_ACCOUNTS_JSON": "{\"work\":{\"smtp\":{\"host\":\"smtp.gmail.com\",\"port\":587,\"user\":\"work@company.com\",\"password\":\"app-password\"},\"imap\":{\"host\":\"imap.gmail.com\",\"port\":993,\"user\":\"work@company.com\",\"password\":\"app-password\"},\"default_from_name\":\"John Doe\"},\"personal\":{\"smtp\":{\"host\":\"smtp.mail.me.com\",\"port\":587,\"user\":\"me@icloud.com\",\"password\":\"app-password\"},\"imap\":{\"host\":\"imap.mail.me.com\",\"port\":993,\"user\":\"me@icloud.com\",\"password\":\"app-password\"},\"default_from_name\":\"John\"}}",
"DEFAULT_EMAIL_ACCOUNT": "work"The server also accepts flat or single-account environment variables. For compatibility, SMTP_USERNAME/SMTP_PASSWORD are aliases for SMTP_USER/SMTP_PASS, IMAP_USERNAME/IMAP_PASSWORD are aliases for IMAP_USER/IMAP_PASS, and IMAP_USER/IMAP_PASS fall back to the SMTP credentials when omitted.
Tool | Description |
| Search emails with flexible filters (sender, subject, date, attachments, etc.) |
| Mark as read/unread, flag, archive, or move emails |
| Send new emails with HTML content and attachments |
| Reply or forward emails with proper threading |
| List all available email folders |
Ask Claude to:
"Find unread emails from last week"
"Send an email to team@company.com about the meeting"
"Reply to the last email from Sarah"
"Archive all emails older than 30 days"
"List my email folders"
"Find emails with attachments from my boss"
"Mark all emails from newsletter@site.com as read"
Never commit .env files or credentials to version control
Use app-specific passwords or app passwords, not your main account password
The server runs locally on your machine - credentials stay private
All email connections use TLS encryption (ports 587 for SMTP, 993 for IMAP)
# Clone the repository
git clone https://github.com/samihalawa/email-smtp-imap-mcp.git
cd email-smtp-imap-mcp
# Install dependencies
npm install
# Build
npm run build
# Run locally
npm startMake sure you're using an app password, not your regular password
For Gmail: Create App Password
For iCloud: Generate App-Specific Password
Verify your configuration JSON is properly escaped
Check that ports 587 (SMTP) and 993 (IMAP) are not blocked by your firewall
Restart Claude Desktop after configuration changes
Confirm your email provider allows IMAP/SMTP access
Check your internet connection
Verify the SMTP/IMAP host and port settings for your provider
MIT License - see LICENSE file for details
Contributions are welcome! Please feel free to submit a Pull Request.
Sami Halawa - GitHub
Made with ❤️ for the MCP community
Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/samihalawa/email-smtp-imap-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server