mailsocket MCP Server

by mailsocketapp.mailsocket/mailsocket-mcpv0.4.0

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

0Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install mailsocket MCP server

claude mcp add mailsocket -e MAILSOCKET_API_KEY='<mailsocket-api-key>' -- uvx mailsocket-mcp

{
  "mcpServers": {
    "mailsocket": {
      "command": "uvx",
      "args": [
        "mailsocket-mcp"
      ],
      "env": {
        "MAILSOCKET_API_KEY": "<mailsocket-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mailsocket": {
      "command": "uvx",
      "args": [
        "mailsocket-mcp"
      ],
      "env": {
        "MAILSOCKET_API_KEY": "<mailsocket-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mailsocket": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mailsocket-mcp"
      ],
      "env": {
        "MAILSOCKET_API_KEY": "<mailsocket-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mailsocket": {
      "command": "uvx",
      "args": [
        "mailsocket-mcp"
      ],
      "env": {
        "MAILSOCKET_API_KEY": "<mailsocket-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MAILSOCKET_API_KEY	yes	yes	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.

Remote endpoints

streamable-httphttps://mcp.mailsocket.app/mcp

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-08 · 2d ago · official registry · v0.4.0

FAQ

›How do I install the mailsocket MCP server in Claude Code?

Run: claude mcp add mailsocket -e MAILSOCKET_API_KEY='<mailsocket-api-key>' -- uvx mailsocket-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does mailsocket require an API key?

Yes. It expects MAILSOCKET_API_KEY, of which 1 is a secret.

›Can I use mailsocket as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is mailsocket in the official MCP registry?

Yes, as app.mailsocket/mailsocket-mcp.