English Français العربية

mailsocket

Official registry Productivity

Email inboxes for AI agents: create an inbox, then block until the OTP or magic link arrives.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mailsocket 'https://mcp.mailsocket.app/mcp' --header 'Authorization: <Bearer ms_live_... (create a key in the dashboard or via POST /api/v1/agents/register)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mailsocket": {
            "type": "http",
            "url": "https://mcp.mailsocket.app/mcp",
            "headers": {
                "Authorization": "<Bearer ms_live_... (create a key in the dashboard or via POST /api/v1/agents/register)>"
            }
        }
    }
}
PYPI package mailsocket-mcp
Claude Code 
claude mcp add mailsocket -e 'MAILSOCKET_API_KEY=<your mailsocket_api_key>' -e 'MAILSOCKET_BASE_URL=<MAILSOCKET_BASE_URL>' -- uvx mailsocket-mcp==0.4.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mailsocket": {
            "command": "uvx",
            "args": [
                "mailsocket-mcp==0.4.1"
            ],
            "env": {
                "MAILSOCKET_API_KEY": "<your mailsocket_api_key>",
                "MAILSOCKET_BASE_URL": "<MAILSOCKET_BASE_URL>"
            }
        }
    }
}

Environment variables

  • MAILSOCKET_API_KEY required secret mailsocket API key (ms_live_...). Create one in the dashboard or via POST /api/v1/agents/register.
  • MAILSOCKET_BASE_URL Override the API base URL. Defaults to https://dash.mailsocket.app/api/v1.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mailsocket SDKs & MCP server
  2. MCP config
  3. Examples
  4. License

mailsocket SDKs & MCP server

mailsocket is an inbox API for OTP and magic-link signup automation: email in, JSON out. GET /inboxes/{id}/messages/wait?require=otp blocks and returns the OTP the instant it arrives — no polling, no IMAP. Built for signup automation, E2E tests, and AI agents.

This repo holds the official client packages.

PackageInstallDocs
Pythonpip install mailsocketpython/
TypeScript / Nodenpm i mailsocket-sdktypescript/
MCP server (AI agents)uvx mailsocket-mcpmcp/

Full docs: mailsocket.app · dash.mailsocket.app/docs/

MCP config

Point any MCP-compatible client (Claude Desktop, Cursor, Claude Code) at the mailsocket-mcp server over stdio:

{
  "mcpServers": {
    "mailsocket": {
      "command": "uvx",
      "args": ["mailsocket-mcp"],
      "env": {
        "MAILSOCKET_API_KEY": "ms_live_..."
      }
    }
  }
}

See mcp/README.md for per-client config file locations and the full tool list.

Examples

examples/playwright/ — a reference Playwright test that fills a signup form with a mailsocket inbox address and blocks on the wait endpoint until the OTP arrives.

License

MIT — see LICENSE.

Frequently asked questions

What is mailsocket?

Email inboxes for AI agents: create an inbox, then block until the OTP or magic link arrives.

How do I install mailsocket?

It runs as a remote server. In Claude Code: claude mcp add --transport http mailsocket 'https://mcp.mailsocket.app/mcp' --header 'Authorization: <Bearer ms_live_... (create a key in the dashboard or via POST /api/v1/agents/register)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does mailsocket need an API key?

Yes. It expects MAILSOCKET_API_KEY, Authorization, which you set in its configuration.

Is mailsocket open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains mailsocket?

It is published by mailsocket. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.