# mcp

Assigns email addresses to agents, catches incoming OTP messages, and manages structured task handoffs across runs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 50
- Author: openagentemail
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openagentemail/openagentemail
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/openagentemail-mcp

## What it does

This package bridges AI clients to an OpenAgentEmail setup using the Model Context Protocol. It allows assistants to register logical email identities on your domain, inspect incoming messages, and extract one-time passcodes or verification links directly.

Beyond basic mail handling, the server records task handoffs between separate agents. A requester creates a task for a target recipient, tracks progress in a shared thread, and stores approval verdicts. The server only logs decisions and results; running the reviewed action remains the agent's responsibility.

Running this integration requires `OPENAGENTEMAIL_API_KEY` and `OPENAGENTEMAIL_API_URL`. Without an active OpenAgentEmail backend hosted via Docker Compose or tied to IMAP and SMTP endpoints, the tool calls will fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OPENAGENTEMAIL_API_KEY`, `OPENAGENTEMAIL_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OPENAGENTEMAIL_API_KEY=<OPENAGENTEMAIL_API_KEY> --env OPENAGENTEMAIL_API_URL=<OPENAGENTEMAIL_API_URL> --transport stdio openagentemail-mcp -- npx -y @openagentemail/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add openagentemail-mcp --env OPENAGENTEMAIL_API_KEY=<OPENAGENTEMAIL_API_KEY> --env OPENAGENTEMAIL_API_URL=<OPENAGENTEMAIL_API_URL> -- npx -y @openagentemail/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openagentemail-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@openagentemail/mcp"
            ],
            "env": {
                "OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>",
                "OPENAGENTEMAIL_API_URL": "<OPENAGENTEMAIL_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openagentemail-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@openagentemail/mcp"
            ],
            "env": {
                "OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>",
                "OPENAGENTEMAIL_API_URL": "<OPENAGENTEMAIL_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OPENAGENTEMAIL_API_KEY=<OPENAGENTEMAIL_API_KEY> -e OPENAGENTEMAIL_API_URL=<OPENAGENTEMAIL_API_URL> openagentemail-mcp npx -y @openagentemail/mcp
```
Replace <…> with your own values

## When to use it
- extract verification codes and links from incoming emails
- provision dedicated mail addresses for automated agents
- relay task state and results across separate agent sessions
- record explicit reviewer approval or rejection on staged actions

## Example prompts
- Check the agent mailbox and read the latest verification code.
- Create a code review task for the recipient agent with the latest diff.
- Send a build notification email to the team distribution list.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
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