Skip to main content
Glama

Email MCP Server

by x-mahar

Email MCP Server

A minimal, production-ready MCP (Model Context Protocol) server that enables Claude Desktop to send emails via Mailjet's API over Server-Sent Events (SSE).

🚀 Quick Start

1. Deploy the Server

Local Development:

# Clone and setup git clone <your-repo> cd email-mcp-server pip install -r requirements.txt # Configure environment cp .env.example .env # Edit .env with your API tokens # Run server python main.py # Server runs on http://localhost:8000

Production Deploy (Railway/Render/Vercel):

  1. Fork this repository
  2. Connect to your hosting platform
  3. Set environment variables:
    • VALID_API_TOKENS=your-secure-tokens-here
    • HOST=0.0.0.0
    • PORT=8000

2. Get Your API Token

Visit your deployed server at https://your-domain.com and get a valid API token from the VALID_API_TOKENS environment variable.

3. Configure Claude Desktop

Add this to your Claude Desktop MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "email-sender": { "transport": { "type": "sse", "url": "https://your-domain.com/sse?api_token=your-api-token" } } } }

4. Get Mailjet Credentials

  1. Sign up at Mailjet.com (free tier available)
  2. Go to Account Settings → API Keys
  3. Copy your API Key and Secret Key

5. Send Emails with Claude

Now you can ask Claude to send emails:

"Send an email to john@example.com with the subject 'Meeting Follow-up' saying 'Thanks for the great discussion today. Let's schedule a follow-up for next week.'"

Claude will ask for your Mailjet credentials the first time.

🛡️ Security Features

  • API Token Authentication: Each request requires a valid token
  • User-Provided Credentials: Server never stores user email credentials
  • Input Validation: Email format validation and error handling
  • CORS Protection: Configurable origin restrictions

📡 API Endpoints

  • GET / - Server status and information
  • GET /sse?api_token=TOKEN - SSE endpoint for MCP protocol
  • POST /mcp?api_token=TOKEN - Direct MCP message handling (debugging)

🔧 Environment Variables

HOST=0.0.0.0 # Server host PORT=8000 # Server port VALID_API_TOKENS=token1,token2 # Comma-separated valid tokens

📝 Usage Examples

Basic Email:

Send email to user@domain.com saying "Hello World"

With HTML:

Send a professional email to client@company.com with subject "Proposal" including both plain text and HTML formatting

Multiple Recipients (coming soon): Currently supports single emails only. Bulk email functionality planned for v2.

🚨 Troubleshooting

Common Issues:

  1. "Invalid API token" - Check your token in the SSE URL
  2. "Invalid Mailjet credentials" - Verify your API key and secret
  3. "Invalid email format" - Ensure email addresses are properly formatted
  4. Connection timeouts - Check your server deployment status

🏗️ Architecture

  • FastAPI - Modern Python web framework
  • SSE Transport - Real-time MCP protocol communication
  • Mailjet API - Reliable email delivery service
  • In-Memory Auth - Simple token validation (no database required)

📄 License

MIT License - feel free to use in your own projects!

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

For major changes, please open an issue first to discuss the proposed changes.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables Claude Desktop to send emails through Mailjet's API using the Model Context Protocol over Server-Sent Events. Provides secure email sending capabilities with API token authentication and user-provided credentials.

  1. 🚀 Quick Start
    1. 1. Deploy the Server
    2. 2. Get Your API Token
    3. 3. Configure Claude Desktop
    4. 4. Get Mailjet Credentials
    5. 5. Send Emails with Claude
  2. 🛡️ Security Features
    1. 📡 API Endpoints
      1. 🔧 Environment Variables
        1. 📝 Usage Examples
          1. 🚨 Troubleshooting
            1. 🏗️ Architecture
              1. 📄 License
                1. 🤝 Contributing

                  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/x-mahar/mail-mcpServer'

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