README

@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

Visit https://www.1tempmail.com/api/
Sign in with Google
Click "Generate API Key"
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

@1tempmail/mcp-server

README

@1tempmail/mcp-server

Install

Get Your API Key

Configuration

Usage with AI Tools

Claude Code

Cursor

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

Tools

Environment Variables

License

Recommended Servers