Agentboxd — Claude Code MCP server for agent email
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.
claude mcp add --transport http mcp https://mcp.agentboxd.com/mcpWhat Agentboxd 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.
What it helps with
- 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 for the agent
- 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.
How to install Agentboxd
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.agentboxd.com/mcpPlatform CLI: remote server
codex mcp add mcp --url https://mcp.agentboxd.com/mcpConfig file
{
"mcpServers": {
"mcp": {
"url": "https://mcp.agentboxd.com/mcp"
}
}
}Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.agentboxd.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http mcp https://mcp.agentboxd.com/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 Agentboxd
How do I install Agentboxd in Claude Code?
Run claude mcp add --transport http mcp https://mcp.agentboxd.com/mcp, then sign in to Agentboxd when prompted.
What does Agentboxd do?
It gives an AI agent tools to create inboxes, send and read email, search messages, and retrieve verification codes.
Can Agentboxd run without an API key?
Yes. In a local setup, the agent gets a signup tool that creates a workspace with one inbox. Sending mail is limited until a person claims the workspace.
