Email inboxes for AI agents: create an inbox, then block until the OTP or magic link arrives.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add mailsocket --env MAILSOCKET_API_KEY='<MAILSOCKET_API_KEY>' -- uvx mailsocket-mcp~/.codex/config.toml
[mcp_servers.mailsocket]
command = "uvx"
args = ["mailsocket-mcp"]
env = { MAILSOCKET_API_KEY = "<MAILSOCKET_API_KEY>" }
# codex mcp add mailsocket --env MAILSOCKET_API_KEY='<MAILSOCKET_API_KEY>' -- uvx mailsocket-mcp~/.cursor/mcp.json
{
"mcpServers": {
"mailsocket": {
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"mailsocket": {
"type": "stdio",
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mailsocket": {
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"mailsocket": {
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"mailsocket": {
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http mailsocket https://mcp.mailsocket.app/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.mailsocket]
url = "https://mcp.mailsocket.app/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add mailsocket --url https://mcp.mailsocket.app/mcp~/.cursor/mcp.json
{
"mcpServers": {
"mailsocket": {
"url": "https://mcp.mailsocket.app/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"mailsocket": {
"type": "http",
"url": "https://mcp.mailsocket.app/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mailsocket": {
"httpUrl": "https://mcp.mailsocket.app/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"mailsocket": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.mailsocket.app/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"mailsocket": {
"url": "https://mcp.mailsocket.app/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
MAILSOCKET_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.