Skip to main content
Glama
pmbstyle

Universal Email MCP Server

by pmbstyle

Universal Email MCP Server

Connect any email provider to your AI assistant in minutes. Zero friction, maximum security.

Python 3.12+ MCP 1.2+ Docker License: MIT

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.

🏆 Available Tools

Account Management

  • add_account - Add email account with IMAP/SMTP settings

  • list_accounts - View all configured accounts

  • remove_account - Remove account configuration

Email Operations

  • 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: Email MCP Server

⚡ Quick Start (Choose Your Path)

1. Claude Desktop (30 seconds) 🎯

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"
    }
  }
}

2. One-Command Setup ⚡

# Works on Windows, Mac, Linux
poetry run universal-email-cli deploy claude-desktop

3. Docker (Cloud ready)

# Creates config automatically
docker run -v ~/.claude-email-mcp:/data -p 8000:8000 universal-email-mcp:latest

📦 Installation

git clone <repo-url>
cd universal-email-mcp-server
poetry install
poetry run universal-email-cli deploy claude-desktop  # Done!

🖥️ Client Configurations

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"
    }
  }
}

Cursor IDE

Same as Claude Desktop - supports both stdio and HTTP transports.

Cloud Deployment

Use HTTP with Bearer tokens - see DEPLOYMENT.md

📧 Email Prompt Examples

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.

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    F
    maintenance
    Enables AI assistants to read, search, compose, and send emails by connecting to any IMAP/SMTP provider. It supports comprehensive mailbox management, including draft handling and message deletion, directly through natural language.
    10
    152
    9
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables email integration via IMAP and SMTP, allowing model assistants to read, send, search emails, and list folders.
    50
    14
    ISC
  • A
    license
    -
    quality
    B
    maintenance
    Connects AI assistants to email accounts via IMAP/SMTP, enabling reading, searching, sending, and organizing emails with features like smart drafts, scheduling, and attachment handling.
    234
    2
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables AI agents to interact with email accounts via IMAP and SMTP, supporting mailbox listing, email search, retrieval, sending, and management.
    MIT

View all related MCP servers

Related MCP Connectors

  • Email for AI agents — send, receive as a webhook, manage domains, templates, routing.

  • AI email inbox and sending tools with attachments, search, live events, and webhooks.

  • Give an AI agent its own inbox — receive email as a webhook, send over a verified domain.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pmbstyle/universal-email-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server