Skip to content
Conduit

mcp server

mailsocket-sdk

mailsocket SDKs (Python, TypeScript) and MCP server: create an email inbox and wait for the OTP or magic link.

mailsocket/mailsocket-sdkcommunitylistedunreviewednot running here yet
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mailsocket-sdk": {
      "command": "uvx",
      "args": [
        "mailsocket-mcp"
      ],
      "env": {
        "MAILSOCKET_API_KEY": "<your MAILSOCKET_API_KEY>"
      }
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

mailsocket SDKs & MCP server

PyPI - mailsocket PyPI - mailsocket-mcp npm - mailsocket-sdk License: MIT

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.

↑↓ navigate openesc close