manojk0303/lemon-email-mcp

🍋 Lemon Email MCP

The email API that just works. Open source. AI-ready. Zero config.

⚡ Send Your First Email in 30 Seconds

curl -X POST https://lemon-email-mcp-production.up.railway.app/send-email \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Hello World 👋",
    "body": "This was stupid easy to send.",
    "fromemail": "mail@member-notification.com",
    "api_key": "your-key-here"
  }'

Need an API key? → DM @Norman_Szobotka or email manojk030303@gmail.com

💡 Pro tip: Use mail@member-notification.com as your sender - it's pre-configured and works with any API key!

🚀 Why This is a No-Brainer

🌐 Use Our API (Recommended)

• Zero setup required
• Works instantly
• Use mail@member-notification.com as sender (pre-configured)
• Or configure your own domain
• Global infrastructure
• Free to try

🏠 Run Locally (Open Source)

• Full source code available
• Host anywhere you want
• Customize everything
• MIT licensed

🤖 AI Integration

• Built for AI agents and assistants
• MCP protocol support
• Works with Claude Desktop, Continue.dev, and more
• Perfect for automation

🛠 Quick Integrations

const response = await fetch('https://lemon-email-mcp-production.up.railway.app/send-email', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    to: 'user@example.com',
    subject: 'Your app just got email superpowers',
    body: 'Welcome to the future!',
    fromemail: 'mail@member-notification.com', // Pre-configured sender
    api_key: 'your-key-here'
  })
});

const result = await response.json();
console.log('Email sent!', result);

import requests

response = requests.post('https://lemon-email-mcp-production.up.railway.app/send-email', json={
    'to': 'user@example.com',
    'subject': 'Python made this easy',
    'body': 'No complicated setup needed!',
    'fromemail': 'mail@member-notification.com',  # Pre-configured sender
    'api_key': 'your-key-here'
})

print('Done!', response.json())

git clone https://github.com/manojk0303/lemon-email-mcp.git
cd lemon-email-mcp
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

name: Lemon Email MCP Server
version: 1.0.0
schema: v1
mcpServers:
  - name: Email Assistant
    command: /path/to/your/lemon-email-mcp/venv/bin/python
    args:
      - "/path/to/your/lemon-email-mcp/simple_mcp_server.py"
    env:
      LEMON_EMAIL_API_KEY: "your-key-here"

"Send a welcome email to user@example.com"

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

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

🏠 Run It Locally (Open Source)

1. Clone & Setup

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

# Set your API key
export LEMON_EMAIL_API_KEY="your-key-here"

2. Test MCP Server

python simple_mcp_server.py test

3. Start Web Server (Optional)

python web_server.py
# Your local server runs at http://localhost:8000

4. Deploy Anywhere

• Railway ✅
• Vercel ✅
• Heroku ✅
• Your own server ✅

🔥 Real Use Cases

🤖 AI Agents

• Customer support automation
• Smart notifications
• Workflow orchestration

🚀 Web Apps

• User onboarding sequences
• Password reset flows
• Order confirmations

⚡ Side Projects

• Newsletter campaigns
• Contact form handling
• Event notifications

📚 What You Get

☁️ Hosted API

• POST /send-email - Send emails instantly
• GET /health - System status
• GET /docs - Interactive documentation

📦 Open Source Code

• Full Python implementation
• MIT license - use anywhere
• Deploy to any platform
• Customize everything

🤖 AI-Ready MCP Server

• Works with Claude Desktop
• Continue.dev integration
• VS Code Copilot compatible
• Any MCP-compatible tool

🌟 Getting Started

Option 1: Use Our API (2 minutes)

1. Get API key → DM @Norman_Szobotka
2. Copy code example above
3. Send your first email
4. Done!

Option 2: AI Integration (5 minutes)

1. Clone this repo
2. Install dependencies
3. Configure your AI tool (Claude/Continue.dev)
4. Ask AI to send emails for you

Option 3: Self-Host (10 minutes)

1. Clone and setup locally
2. Deploy to your preferred platform
3. Use your own infrastructure