🍋 Lemon Email MCP - Direct API Integration

Send emails directly from AI agents. No intermediate servers. Zero config.

🚀 What This Does

Connects AI agents directly to Lemon Email API - no intermediate servers, no proxies, just direct API calls.

• ✅ Direct connection to Lemon Email API

• ✅ No Railway or other intermediates - pure API client

• ✅ MCP protocol for AI agent integration

• ✅ Works with Claude Desktop, Continue.dev, Cline

• ✅ Open source - see exactly what it does

Related MCP server: Mailtrap Email Sending

⚡ Quick Start (30 seconds)

1. Clone & Install

git clone https://github.com/manojk0303/lemon-email-mcp.git
cd lemon-email-mcp
pip install -r requirements.txt

2. Get API Key

• DM @Norman_Szobotka on Twitter

• Or email: manojk030303@gmail.com

• You'll get your key instantly!

3. Set API Key

export LEMON_EMAIL_API_KEY="your-key-here"

4. Test It

python simple_mcp_server.py test

Done! 🎉

🔧 Usage Methods

Method 1: Claude Desktop (Recommended for Mac users)

1. Find your Claude config:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this to your config:

{
  "mcpServers": {
    "lemon-email": {
      "command": "python",
      "args": ["/full/path/to/lemon-email-mcp/simple_mcp_server.py"],
      "env": {
        "LEMON_EMAIL_API_KEY": "your-key-here"
      }
    }
  }
}

3. Restart Claude Desktop

4. Test it:

"Send a test email to test@example.com with subject 'Hello from Claude' and body 'This is amazing!'"

Claude will now send emails directly via Lemon API!

Method 2: Continue.dev (VS Code)

1. Install Continue.dev extension in VS Code

2. Create MCP config file:

Create .continue/config.json in your project:

{
  "mcpServers": [
    {
      "name": "lemon-email",
      "command": "python",
      "args": ["/full/path/to/lemon-email-mcp/simple_mcp_server.py"],
      "env": {
        "LEMON_EMAIL_API_KEY": "your-key-here"
      }
    }
  ]
}

3. Restart VS Code

4. Ask Continue:

"Send an email to user@example.com about the new feature"

Method 3: Direct API (No MCP)

Want to use the Lemon API directly in your Python code?

import httpx
import asyncio

async def send_email():
    headers = {
        "Content-Type": "application/json",
        "X-Auth-APIKey": "your-lemon-api-key"
    }
    
    payload = {
        "to": "user@example.com",
        "subject": "Hello World",
        "body": "This is a direct API call!",
        "fromname": "Your App",
        "fromemail": "mail@member-notification.com",
        "tag": "direct-api"
    }
    
    async with httpx.AsyncClient() as client:
        response = await client.post(
            "https://app.xn--lemn-sqa.com/api/transactional/send",
            headers=headers,
            json=payload
        )
        print(response.json())

asyncio.run(send_email())

📚 How It Works

Your AI Agent → MCP Protocol → simple_mcp_server.py → Lemon Email API
                                                              ↓
                                                         📧 Email Sent

No intermediate servers! Direct connection to Lemon Email.

🔍 Available Tool

The MCP server exposes one tool: send_email

Parameters:

• to (required) - Recipient email

• subject (required) - Email subject

• body (required) - Email content

• fromname (optional) - Sender name (default: "Email Assistant")

• fromemail (optional) - Sender email (default: "mail@member-notification.com")

• toname (optional) - Recipient name

• tag (optional) - Email tag for tracking

• variables (optional) - Template variables

• replyto (optional) - Reply-to address

🧪 Testing

Test direct API connection:

python simple_mcp_server.py test

Start MCP server:

python simple_mcp_server.py

Get help:

python simple_mcp_server.py help

🛠️ Troubleshooting

"LEMON_EMAIL_API_KEY required"

• Set environment variable: export LEMON_EMAIL_API_KEY="your-key"

• Or add to your MCP config (see examples above)

"MCP library not available"

pip install mcp httpx pydantic

"Connection timeout"

• Check your internet connection

• Verify API key is correct

• Try test command: python simple_mcp_server.py test

Claude Desktop not seeing the tool

• Verify JSON syntax in config file

• Use full absolute paths, not ~

• Restart Claude Desktop completely

• Check Claude logs for errors

📖 Architecture

What's removed:

• ❌ Railway deployment

• ❌ Web server wrapper

• ❌ FastAPI endpoints

• ❌ Intermediate API layer

What remains:

• ✅ Direct Lemon API client

• ✅ MCP protocol server

• ✅ Pure Python implementation

• ✅ Minimal dependencies

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md

📄 License

MIT License - see LICENSE

🔑 Getting API Key

Need a Lemon Email API key?

1. DM @Norman_Szobotka on Twitter

2. Or email: manojk030303@gmail.com

You'll get your key within seconds!

🌟 Features

• Direct API - No proxies or intermediate servers

• Fast - Direct connection means lower latency

• Simple - One Python file, minimal dependencies

• Reliable - Fewer moving parts = fewer failures

• Open Source - See exactly what it does

• AI-Ready - Perfect for AI agents and automation

Ready to send emails from AI?

Questions? → manojk030303@gmail.com