Manage Gmail accounts via IMAP/SMTP, including listing, sending, and organizing emails.
Click on "Deploy 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., "@Universal Email MCP Server Show me latest 5 unread emails from personal"
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.
Connect any email provider to your AI assistant in minutes. Zero friction, maximum security.
A secure MCP server that connects AI agents to any email provider via IMAP/SMTP protocols. Zero config required for local development, enterprise-ready for cloud deployment.
add_account - Add email account with IMAP/SMTP settings
list_accounts - View all configured accounts
remove_account - Remove account configuration
list_messages - List emails with filtering & pagination
get_message - Get specific email by UID
send_message - Send emails with attachments
mark_message - Mark read/unread
list_mailboxes - Show available folders/mailboxes
Related MCP server: Mailbridge MCP
Windows CMD setup that actually works:
{
"mcpServers": {
"universal-email": {
"command": "cmd",
"args": ["/c", "cd", "/d", "C:\\path\\to\\universal-email-mcp-server", "&&", "poetry", "run", "python", "-m", "universal_email_mcp.stdio_main"],
"cwd": "C:\\path\\to\\universal-email-mcp-server"
}
}
}# Works on Windows, Mac, Linux
poetry run universal-email-cli deploy claude-desktop# Creates config automatically
docker run -v ~/.claude-email-mcp:/data -p 8000:8000 universal-email-mcp:latestgit clone <repo-url>
cd universal-email-mcp-server
poetry install
poetry run universal-email-cli deploy claude-desktop # Done!Windows CMD with proper path handling:
{
"mcpServers": {
"universal-email": {
"command": "cmd",
"args": ["/c", "cd", "/d", "C:\\path\\to\\universal-email-mcp-server", "&&", "poetry", "run", "python", "-m", "universal_email_mcp.stdio_main"],
"cwd": "C:\\path\\to\\universal-email-mcp-server"
}
}
}macOS/Linux:
{
"mcpServers": {
"universal-email": {
"command": "poetry",
"args": ["run", "python", "-m", "universal_email_mcp.stdio_main"],
"cwd": "/path/to/universal-email-mcp-server"
}
}
}Same as Claude Desktop - supports both stdio and HTTP transports.
Use HTTP with Bearer tokens - see DEPLOYMENT.md
Setup:
"Add my Gmail account named 'personal'"
"List all my accounts"Email Management:
"Show me latest 10 unread emails from personal"
"Send email to john@company.com with subject 'Meeting tomorrow'"
"Mark message 12345 as read"🎈 That's it! Run poetry run universal-email-cli deploy claude-desktop and you're connected.
This server cannot be deployed
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
