Skip to main content
Glama
Sign In
pmbstyle

Universal Email MCP Server

by pmbstyle
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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: Mailbridge MCP

⚡ 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

Claude Desktop (Recommended)

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • IMAP Email MCP Server

    jdickey1
    A
    license
    A
    quality
    D
    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
    154 npm
    11
    MIT

  • Mailbridge MCP

    Creativestefan
    A
    license
    Not graded
    quality
    D
    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.
    199 npm
    2
    MIT

  • mcp-imap

    andrewmalov
    A
    license
    Not graded
    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

  • Mail MCP Server

    martinzarfl
    A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to send, read, and manage emails via SMTP and IMAP, with support for attachments, threads, and mailbox organization.
    16
    81 npm
    1
    MIT