{"_id":"@emailit/emailit-mcp","_rev":"2-998a961cf2acfd2e2fde7fe130c8b900","name":"@emailit/emailit-mcp","dist-tags":{"latest":"2.0.3"},"versions":{"2.0.2":{"name":"@emailit/emailit-mcp","version":"2.0.2","keywords":["emailit","mcp","email","api","model-context-protocol"],"license":"MIT","_id":"@emailit/emailit-mcp@2.0.2","maintainers":[{"name":"georgezizka","email":"jiri.zizka@funfirst.cz"}],"homepage":"https://emailit.com","bugs":{"url":"https://github.com/emailit/emailit-mcp/issues"},"bin":{"emailit-mcp":"src/index.js"},"dist":{"shasum":"45588a575b0a20ccd4f223e032efd3be18f85332","tarball":"https://registry.npmjs.org/@emailit/emailit-mcp/-/emailit-mcp-2.0.2.tgz","fileCount":18,"integrity":"sha512-UzxcZaBF0d35tNDI9C3eRM0+qynkfPb3dxxbGtVoXMsyWANPH0zHDMojQ24lc/rJKW7uIJsakDKbUHEEp/ieVg==","signatures":[{"sig":"MEYCIQCoeB93Kr1BzVzwvMcppvPOXZERzSjtz2nm9IGiWcDTHgIhAKjUX5Bo59UfJ8AJDeywqALdtfUUacppETqW2X4ycUIc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@emailit%2femailit-mcp@2.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":69112},"type":"module","engines":{"node":">=18"},"gitHead":"df0ec8eab17441747cb890a081fb1a3ae060c6ee","scripts":{"test":"vitest run","start":"node src/index.js","test:watch":"vitest"},"_npmUser":{"name":"georgezizka","email":"jiri.zizka@funfirst.cz"},"repository":{"url":"git+https://github.com/emailit/emailit-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"MCP server for the Emailit email platform","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.25.11","fastify":"^5.3.3","minimist":"^1.2.8","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4"},"_npmOperationalInternal":{"tmp":"tmp/emailit-mcp_2.0.2_1779215841952_0.36319268438794206","host":"s3://npm-registry-packages-npm-production"}},"2.0.3":{"name":"@emailit/emailit-mcp","version":"2.0.3","description":"MCP server for the Emailit email platform","type":"module","bin":{"emailit-mcp":"src/index.js"},"scripts":{"start":"node src/index.js","test":"vitest run","test:watch":"vitest"},"keywords":["emailit","mcp","email","api","model-context-protocol"],"homepage":"https://emailit.com","license":"MIT","engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","fastify":"^5.3.3","minimist":"^1.2.8","zod":"^3.25.11"},"repository":{"type":"git","url":"git+https://github.com/emailit/emailit-mcp.git"},"publishConfig":{"access":"public"},"devDependencies":{"vitest":"^3.2.4"},"_id":"@emailit/emailit-mcp@2.0.3","gitHead":"23438ebe0e154b3464e179f5f67095d72dd3a8b5","bugs":{"url":"https://github.com/emailit/emailit-mcp/issues"},"_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-qQpVhXPkYjauCH9vjTZEVvss4Yee6RGAnqUSF0sb5xcss7dILuMOuE+6Qg0ohVk1HBtVtMrkVQlF03JTM+3GPQ==","shasum":"8afb4f3ab63be9253768d770e6a8af8f104642b3","tarball":"https://registry.npmjs.org/@emailit/emailit-mcp/-/emailit-mcp-2.0.3.tgz","fileCount":18,"unpackedSize":69079,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@emailit%2femailit-mcp@2.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDonwRa8AoZiHqaAAPN9pY+hQQxxaV3FncIJPZwLk7SzAiEA/b1Ydl9bLo4b3XodCNixyEaQ2zENaVDnRgJfkNS1fRY="}]},"_npmUser":{"name":"georgezizka","email":"jiri.zizka@funfirst.cz"},"directories":{},"maintainers":[{"name":"georgezizka","email":"jiri.zizka@funfirst.cz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/emailit-mcp_2.0.3_1780846869085_0.7569837287168535"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-19T18:37:21.794Z","modified":"2026-06-07T15:41:09.551Z","2.0.2":"2026-05-19T18:37:22.095Z","2.0.3":"2026-06-07T15:41:09.237Z"},"bugs":{"url":"https://github.com/emailit/emailit-mcp/issues"},"license":"MIT","homepage":"https://emailit.com","keywords":["emailit","mcp","email","api","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/emailit/emailit-mcp.git"},"description":"MCP server for the Emailit email platform","maintainers":[{"name":"georgezizka","email":"jiri.zizka@funfirst.cz"}],"readme":"# Emailit MCP Server\n\nAn MCP server for the [Emailit](https://emailit.com/) platform. Send emails, manage contacts, domains, templates, and more, directly from any MCP client like Claude Desktop, Cursor, or Claude Code.\n\n## Features\n\n- **Emails** — Send, list, get, cancel, update, and retry emails. Supports HTML, plain text, attachments, CC/BCC, reply-to, scheduling, tags, templates, and tracking.\n- **Domains** — Create, list, get, update, delete, and verify sender domains. Configure tracking and view DNS records.\n- **API Keys** — Create, list, get, update, and delete API keys.\n- **Audiences** — Create, list, get, update, and delete audiences for campaigns.\n- **Contacts** — Create, list, get, update, and delete contacts. Manage custom fields and audience subscriptions.\n- **Templates** — Create, list, get, update, delete, and publish reusable email templates.\n- **Suppressions** — Create, list, get, update, and delete email suppressions.\n- **Webhooks** — Create, list, get, update, and delete webhooks for event notifications.\n\n## Setup\n\nCreate a free Emailit account and [create an API key](https://emailit.com/docs/guides/how-to-get-an-api-key/). To send to addresses outside of your own, you'll need to [verify your domain](https://emailit.com/docs/guides/creating-a-domain/).\n\n## Usage\n\nThe server supports two transport modes: stdio (default) and HTTP.\n\n### Stdio Transport (Default)\n\n#### Claude Code\n\n```bash\nclaude mcp add emailit -e EMAILIT_API_KEY=em_xxx -- npx -y @emailit/emailit-mcp\n```\n\n#### Cursor\n\nOpen the command palette and choose \"Cursor Settings\" > \"MCP\" > \"Add new global MCP server\".\n\n```json\n{\n  \"mcpServers\": {\n    \"emailit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"emailit-mcp\"],\n      \"env\": {\n        \"EMAILIT_API_KEY\": \"em_xxx\"\n      }\n    }\n  }\n}\n```\n\n#### Claude Desktop\n\nOpen Claude Desktop settings > \"Developer\" tab > \"Edit Config\".\n\n```json\n{\n  \"mcpServers\": {\n    \"emailit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"emailit-mcp\"],\n      \"env\": {\n        \"EMAILIT_API_KEY\": \"em_xxx\"\n      }\n    }\n  }\n}\n```\n\n### HTTP Transport\n\nRun 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.\n\nStart the server:\n\n```bash\nnpx -y @emailit/emailit-mcp --http --port 3000\n```\n\nThe server will listen on `http://127.0.0.1:3000` and expose the MCP endpoint at `/mcp` using Streamable HTTP.\n\n#### Claude Code\n\n```bash\nclaude mcp add emailit --transport http http://127.0.0.1:3000/mcp --header \"Authorization: Bearer em_xxx\"\n```\n\n#### Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"emailit\": {\n      \"url\": \"http://127.0.0.1:3000/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer em_xxx\"\n      }\n    }\n  }\n}\n```\n\nYou can also set the port via the `MCP_PORT` environment variable:\n\n```bash\nMCP_PORT=3000 npx -y @emailit/emailit-mcp --http\n```\n\n### Options\n\nYou can pass additional arguments to configure the server:\n\n- `--key`: Your Emailit API key (stdio mode only; HTTP mode uses the Bearer token from the client)\n- `--sender`: Default sender email address from a verified domain\n- `--reply-to`: Default reply-to email address (can be specified multiple times)\n- `--http`: Use HTTP transport instead of stdio (default: stdio)\n- `--port`: HTTP port when using `--http` (default: 3000, or `MCP_PORT` env var)\n\nEnvironment variables:\n\n- `EMAILIT_API_KEY`: Your Emailit API key (required for stdio, optional for HTTP since clients pass it via Bearer token)\n- `SENDER_EMAIL_ADDRESS`: Default sender email address from a verified domain (optional)\n- `REPLY_TO_EMAIL_ADDRESSES`: Comma-separated reply-to email addresses (optional)\n- `MCP_PORT`: HTTP port when using `--http` (optional)\n\n> **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.\n\n## Local Development\n\n1. Clone this project and install dependencies:\n\n```bash\ngit clone https://github.com/emailit/emailit-mcp.git\ncd emailit-mcp\nnpm install\n```\n\n1. Run locally:\n\n```bash\nEMAILIT_API_KEY=em_xxx node src/index.js\n```\n\n1. For HTTP mode:\n\n```bash\nnode src/index.js --http --port 3000\n```\n\n## License\n\nMIT","readmeFilename":"README.md"}