Cloudflare Email MCP & API Wrapper 📧

Cloudflare Email MCP & API Wrapper 📧

An open-source, production-ready Cloudflare Worker that exposes a JSON API and a Model Context Protocol (MCP) server for sending emails via Cloudflare's Email Service.

Features

• MCP Server: Connect directly to AI agents (Claude, Gemini, etc.) to send emails.
• REST API: Simple JSON endpoint for traditional application integration.
• Advanced Email Support: HTML bodies, multiple recipients (To, CC, BCC), and attachments.
• Edge Performance: Built on Cloudflare Workers for global low-latency.
• Secure: Bearer token authentication for both API and MCP endpoints.

Quick Start (Deploy Once)

1. Prerequisites

• A Cloudflare account with a domain configured for Email Routing.
• bun or npm installed.

2. Installation

git clone https://github.com/sh20raj/cf-email-mcp-api.git
cd cf-email-mcp-api
bun install

3. Configuration

Copy .dev.vars.example to .dev.vars and fill in your local values:

• API_TOKEN: A secure token for endpoint authentication.
• DEFAULT_SENDER: An authorized email address from your Email Routing domain.
• DEFAULT_FROM_NAME: Optional sender display name.

4. Deploy

bun run deploy

🤖 AI Agent Integration (MCP)

Adding to Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "cf-email": {
      "transport": "http",
      "url": "https://your-worker.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Adding to Gemini / Antigravity

Add to your mcp_config.json:

{
  "mcpServers": {
    "cf-email": {
      "transport": "http",
      "url": "https://your-worker.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

🛠️ API Reference

Send Email

POST /api/send

Headers:

• Authorization: Bearer YOUR_API_TOKEN
• Content-Type: application/json

Body:

{
  "to": "[email protected]",
  "subject": "Hello from API",
  "html": "<h1>Professional Email</h1><p>Sent via Cloudflare Workers.</p>",
  "attachments": [
    {
      "name": "report.pdf",
      "type": "application/pdf",
      "data": "BASE64_ENCODED_DATA"
    }
  ]
}

License

MIT