MiniMail MCP Server

MiniMail MCP Server

Multi-service email platform for MCP-compatible clients.

Version 0.3.0-alpha - FastMCP 2.14.3 Standards Compliance

See CHANGELOG.md for version history.

Features

Email Services

• SMTP/IMAP: Standard email providers (Gmail, Outlook, Yahoo, iCloud, ProtonMail)
• Transactional APIs: SendGrid, Mailgun, Resend, Amazon SES, Postmark
• Local Testing: MailHog, Mailpit, MailCatcher, Inbucket
• Webhook Integration: Slack, Discord, Telegram, GitHub

Core Functionality

• Send emails via multiple service types
• Check inbox via IMAP and service APIs
• Dynamic service configuration at runtime
• Email header decoding (UTF-8, Base64, Quoted-Printable)
• Async operations with connection pooling
• Service health monitoring and testing

Standards Compliance

• FastMCP 2.14.3 protocol support
• MCPB packaging for Claude Desktop
• Zed extension support
• Conversational tool returns
• Structured logging with JSON output

Standards Compliance

This minimail-mcp implements current MCP server standards:

MCPB Packaging (Claude Desktop)

• Complete manifest.json with tool definitions
• Prompt templates for Claude Desktop integration
• Self-contained source code packaging
• Icon and documentation assets

Glama Integration

• glama.json configuration for Glama MCP client discovery
• Feature categorization and capability descriptions
• Code review and documentation generation configuration
• Status and development information

CI/CD Pipeline

• GitHub Actions workflow with multi-Python version testing (3.10, 3.11, 3.12)
• Automated linting with Ruff
• Type checking with MyPy
• Test coverage reporting
• Security scanning with Bandit
• Package building and MCPB creation
• PyPI publishing requires account setup

Monitoring Stack

• Health check system for email services
• Performance metrics collection
• System resource monitoring
• Service availability tracking

Development Standards

• Testing suite with pytest
• Code quality enforcement with Ruff and MyPy
• Project structure with src/ layout
• Dependency management with pyproject.toml
• Documentation and examples

Supported Services

Standard Email Providers

• Gmail - SMTP/IMAP with App Passwords
• Outlook/Hotmail - SMTP/IMAP
• Yahoo Mail - SMTP/IMAP
• iCloud Mail - SMTP/IMAP
• ProtonMail - SMTP/IMAP (requires ProtonMail Bridge for free accounts, or paid account for direct access)

Transactional Email APIs

• SendGrid - Enterprise email delivery
• Mailgun - Developer-friendly email API
• Resend - Modern email API
• Amazon SES - AWS email service
• Postmark - Reliable transactional email

Local Testing Services

• MailHog - Web UI for email testing
• Mailpit - Modern mail testing
• MailCatcher - Ruby-based testing
• Inbucket - Lightweight testing

Webhook/Dev Services

• Slack - Send emails as Slack messages
• Discord - Send emails as Discord messages
• Telegram - Bot message forwarding
• GitHub - Email to issue/PR comments

🚀 Installation

Prerequisites

• uv installed (RECOMMENDED)
• Python 3.12+

📦 Quick Start

Run immediately via uvx:

uvx email-mcp

🎯 Claude Desktop Integration

Add to your claude_desktop_config.json:

"mcpServers": {
  "email-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/email-mcp", "run", "email-mcp"]
  }
}

🚀 Installation

Prerequisites

• uv installed (RECOMMENDED)
• Python 3.12+

📦 Quick Start

Run immediately via uvx:

uvx email-mcp

🎯 Claude Desktop Integration

Add to your claude_desktop_config.json:

"mcpServers": {
  "email-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/email-mcp", "run", "email-mcp"]
  }
}

Claude Desktop (MCPB)

1. Download the minimail-mcp.mcpb package (when built)
2. Drag and drop into Claude Desktop settings
3. The server will be automatically configured

Glama Client

The server is automatically discoverable by Glama.ai's GitHub scraping system through the glama.json configuration.

Gmail Integration

The minimail-mcp supports Gmail SMTP with App Password authentication:

Configuration

{
  "SenderEmail": "your-email@gmail.com",
  "SenderName": "Your Name",
  "SmtpServer": "smtp.gmail.com",
  "SmtpPort": 587,
  "SmtpUsername": "your-email@gmail.com",
  "SmtpPassword": "your-gmail-app-password"
}

Setup Steps

1. Enable 2-Factor Authentication on Gmail account
2. Generate App Password at https://myaccount.google.com/apppasswords
3. Use App Password for SMTP authentication
4. Configure using configure_service() or environment variables

Supported Features

• SMTP email sending with TLS encryption
• HTML and plain text email formats
• CC/BCC recipient support
• Authentication with App Passwords
• Error handling and connection test