A
security-
licenseA
qualityGives on-the-fly inboxes to AI agents. Agents / LLM's can send, receive, and take action in isolated inboxes. Built for AI unlike Gmail. Check us out at agentmail.to
Last updated -
10
33
Built using Python as the implementation language for the MCP server
🍋 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
⚡ 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.jsonWindows:
%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 emailsubject(required) - Email subjectbody(required) - Email contentfromname(optional) - Sender name (default: "Email Assistant")fromemail(optional) - Sender email (default: "mail@member-notification.com")toname(optional) - Recipient nametag(optional) - Email tag for trackingvariables(optional) - Template variablesreplyto(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?
DM @Norman_Szobotka on Twitter
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
This server cannot be installed
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityIntegrates with Mailtrap Email Platform to enable sending transactional emails via API.Last updated -15549MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI models to send emails via simple tool calls, supporting both plain text and HTML formats with JWT authentication.Last updated -1298
- -securityAlicense-qualityProvides AI assistants with the ability to manage email accounts through cPanel's UAPI, enabling automated email account creation, deletion, configuration, and forwarding management.Last updated -2MIT License