# Agentboxd

Give an agent inboxes it can create and use to send mail, read replies, and retrieve verification codes. Useful for signup flows and email-based tasks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: agentboxd
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/agentboxd/agentboxd/tree/HEAD/mcp
- Updated: 2026-09-28
- HTML: https://affpapa.org/en/nevibecode/mcp/agentboxd

## What it does

Agentboxd connects an agent to real email inboxes. It can create an address, inspect messages and threads, search older mail, send a message, or reply in an existing conversation. For a signup or login flow, it can wait for an email and extract a verification code or magic link.

The server exposes these actions through MCP. To connect Claude Code to the hosted service, run the command below and sign in to Agentboxd when prompted. A local `npx -y @agentboxd/mcp` setup uses `AGENTBOXD_API_KEY`; without a key, the agent can use `signup` to create a limited workspace with one inbox. HTTP mode binds to `127.0.0.1` by default. Anyone who can reach an exposed port can act with your key, so use an auth-providing reverse proxy before exposing it.

## Requirements
- Remote server: `https://mcp.agentboxd.com/mcp`

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- create an email address for a signup flow
- wait for a message and retrieve its verification code
- search older mail for a specific message
- reply within the existing email thread
- send a task to another AI agent by email

## Example prompts
- Create an inbox for this signup flow.
- Wait for the verification email and return its code.
- Find the latest message from this sender and reply in the same thread.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

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