@1tempmail/mcp-server

MCP Server for 1TempMail — Generate temporary emails, check inboxes, and read messages via AI assistants.

Install

npm install -g @1tempmail/mcp-server

Or use directly with npx (no install needed):

npx -y @1tempmail/mcp-server

Get Your API Key

1. Visit https://www.1tempmail.com/api/
2. Sign in with Google
3. Click "Generate API Key"
4. Copy your API key

Configuration

Set the 1TEMPMAIL_API_KEY environment variable:

export 1TEMPMAIL_API_KEY="your_api_key_here"

Usage with AI Tools

Claude Code

Add to ~/.claude/settings.json or your project's .claude/settings.json:

{
  "mcpServers": {
    "1tempmail": {
      "command": "npx",
      "args": ["-y", "@1tempmail/mcp-server"],
      "env": {
        "1TEMPMAIL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json or your project's .cursor/mcp.json:

{
  "mcpServers": {
    "1tempmail": {
      "command": "npx",
      "args": ["-y", "@1tempmail/mcp-server"],
      "env": {
        "1TEMPMAIL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Other MCP-Compatible Tools (Windsurf, Cline, etc.)

Add the same server config to your tool's MCP settings file.

Tools

| Tool | Description | |------|-------------| | generate_email | Generate a new temporary email address (active for 60 minutes) | | check_inbox | Retrieve all messages in the inbox for a given session token | | get_message | Retrieve the full content of a specific message |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | 1TEMPMAIL_API_KEY | Yes | — | Your 1TempMail API key | | 1TEMPMAIL_API_BASE | No | https://www.1tempmail.com | API base URL |

License

MIT