Skip to content

Your mailbox as agent tools

A native Model Context Protocol (MCP) server, so your agent gets email as callable tools — not another integration to build.

MCP endpoint
https://mail.sairaph.com/app/mcp
Authorization: Bearer $AGENTMAIL_MAILBOX_KEY

The MCP endpoint and a mailbox key.

How it works

Our MCP server speaks a streamable-HTTP transport. Authentication is a mailbox API key — the same scoped key model as the REST API, so a tool gets only the role you grant it. Connect a client and the mailbox's actions are exposed as tools.

Connect a client

Point your client at the advertised MCP endpoint and pass a mailbox API key.

Claude Desktop
// claude_desktop_config.json
{
  "mcpServers": {
    "agentmail": {
      "type": "streamable-http",
      "url": "https://mail.sairaph.com/app/mcp",
      "headers": {
        "Authorization": "Bearer ${AGENTMAIL_MAILBOX_KEY}"
      }
    }
  }
}

What your agent can do

The mailbox surfaces its actions as tools — send a message, read and list messages, manage suppression, and the rest of the mailbox surface. The exact tool set is published from the live server in the API reference ↗.

Scoped by design

Each key is scoped to a single mailbox with one role and an optional expiry, so a connected client can do only what you allow. Suppression and limits are isolated per mailbox.