UniOne — Claude Code MCP server: features and setup
This MCP server for Claude Code connects an agent to UniOne transactional email. It can send messages and manage sender domains, templates, and webhooks.
MIT updated 2026-11-06
claude mcp add --transport http mcp https://mcp.unione.io/mcpWhat UniOne does
The server gives an AI agent access to UniOne account operations, including email delivery, address validation, sender domains, templates, webhooks, suppressions, and projects. It also handles tags and event dumps. Some actions are irreversible: sent mail cannot be recalled, and address validation is billed per address.
The hosted server uses OAuth at https://mcp.unione.io/mcp. For a local setup, provide a UniOne API key through UNIONE_API_KEY; the npx option needs Node.js 18+, while Docker and a binary are also available. Local mode can expose read tools only with MCP_READ_ONLY=1, or hide email sending with MCP_DISABLE_SEND=1. These switches do not restrict direct use of the same key with the Web API.
What it helps with
- send a transactional email through UniOne
- check DNS records for a sender domain
- create or replace an email template
- request an event dump and inspect suppressions
Example prompts for the agent
- Send a transactional email through UniOne to the address in this task.
- List my sender domains and check the DNS records for the selected domain.
- Show the available templates and update the one named in this task.
How to install UniOne
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.unione.io/mcpPlatform CLI: remote server
codex mcp add unione --url https://mcp.unione.io/mcpConfig file
{
"mcpServers": {
"unione": {
"url": "https://mcp.unione.io/mcp"
}
}
}Config file
{
"servers": {
"unione": {
"type": "http",
"url": "https://mcp.unione.io/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http unione https://mcp.unione.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about UniOne
How do I install UniOne in Claude Code?
Add the hosted MCP server with claude mcp add --transport http unione https://mcp.unione.io/mcp. On first connection, sign in to UniOne and approve OAuth access.
What does UniOne do?
It lets an AI agent send email through UniOne and manage account resources such as domains, templates, webhooks, suppressions, and projects. Some operations cannot be reversed, and email validation is billed per address.
What does UniOne need to run?
The hosted option needs a UniOne account and OAuth authorization. A local server needs a UniOne API key in UNIONE_API_KEY; using npx also requires Node.js 18+.