Emailit MCP Server

An MCP server for the Emailit platform. Send emails, manage contacts, domains, templates, and more, directly from any MCP client like Claude Desktop, Cursor, or Claude Code.

This package runs locally with an Emailit API key. Emailit also hosts an MCP server at https://api.emailit.com/mcp that you sign in to with OAuth, no key or install needed: see emailit.com/docs/mcp.

Features

• Emails — Send, list, get, cancel, update, and retry emails. Supports HTML, plain text, attachments, CC/BCC, reply-to, scheduling, tags, templates, and tracking.

• Domains — Create, list, get, update, delete, and verify sender domains. Configure tracking and view DNS records.

• API Keys — Create, list, get, update, and delete API keys.

• Audiences — Create, list, get, update, and delete audiences for campaigns.

• Contacts — Create, list, get, update, and delete contacts. Manage custom fields and audience subscriptions.

• Templates — Create, list, get, update, delete, and publish reusable email templates.

• Suppressions — Create, list, get, update, and delete email suppressions.

• Webhooks — Create, list, get, update, and delete webhooks for event notifications.

Related MCP server: mailtarget

Setup

Create a free Emailit account and create an API key. To send to addresses outside of your own, you'll need to verify your domain.

Usage

The server supports two transport modes: stdio (default) and HTTP.

Stdio Transport (Default)

Claude Code

claude mcp add emailit -e EMAILIT_API_KEY=secret_xxx -- npx -y @emailit/emailit-mcp

Cursor

Open the command palette and choose "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "secret_xxx"
      }
    }
  }
}

Claude Desktop

Open Claude Desktop settings > "Developer" tab > "Edit Config".

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "secret_xxx"
      }
    }
  }
}

HTTP Transport

Run the server over HTTP for remote or web-based integrations. In HTTP mode, each client authenticates by passing their Emailit API key as a Bearer token in the Authorization header.

Start the server:

npx -y @emailit/emailit-mcp --http --port 3000

The server will listen on http://127.0.0.1:3000 and expose the MCP endpoint at /mcp using Streamable HTTP.

Claude Code

claude mcp add emailit --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer secret_xxx"

Cursor

{
  "mcpServers": {
    "emailit": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer secret_xxx"
      }
    }
  }
}

You can also set the port via the MCP_PORT environment variable:

MCP_PORT=3000 npx -y @emailit/emailit-mcp --http

Options

You can pass additional arguments to configure the server:

• --key: Your Emailit API key (stdio mode only; HTTP mode uses the Bearer token from the client)

• --sender: Default sender email address from a verified domain

• --reply-to: Default reply-to email address (can be specified multiple times)

• --http: Use HTTP transport instead of stdio (default: stdio)

• --port: HTTP port when using --http (default: 3000, or MCP_PORT env var)

Environment variables:

• EMAILIT_API_KEY: Your Emailit API key (required for stdio, optional for HTTP since clients pass it via Bearer token)

• SENDER_EMAIL_ADDRESS: Default sender email address from a verified domain (optional)

• REPLY_TO_EMAIL_ADDRESSES: Comma-separated reply-to email addresses (optional)

• MCP_PORT: HTTP port when using --http (optional)

Note: If you don't provide a sender email address, the MCP server will ask you to provide one each time you send an email.

Local Development

1. Clone this project and install dependencies:

git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install

1. Run locally:

EMAILIT_API_KEY=secret_xxx node src/index.js

1. For HTTP mode:

node src/index.js --http --port 3000

License

MIT