# UniOne

This MCP server for Claude Code connects an agent to UniOne transactional email. It can send messages and manage sender domains, templates, and webhooks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: unione-repo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/unione-repo/unione-mcp
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/unione

## What it 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.

## Requirements
- Remote server: `https://mcp.unione.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.unione.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add unione --url https://mcp.unione.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unione": {
            "url": "https://mcp.unione.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unione": {
            "type": "http",
            "url": "https://mcp.unione.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http unione https://mcp.unione.io/mcp
```

## When to use it
- 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
- 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.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
