# mcp-server-tempmail

Connects ChatTempMail to your coding assistant to generate disposable email inboxes and inspect incoming messages.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: Selenium39
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Selenium39/mcp-server-tempmail
- Updated: 2025-09-09
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-server-tempmail

## What it does

This MCP server integrates the `chat-tempmail.com` API into coding assistants. It provides tools to retrieve available domains, create disposable addresses, and clean up expired mailboxes. When setting up an inbox, you can choose a lifespan ranging from 1 hour to indefinite.

The model can query received messages, inspect the full content of any email, and delete specific items. It also contains tools to inspect or update webhook URLs for incoming email events.

You need a personal key set in `TEMPMAIL_API_KEY` before starting. Without this credential from chat-tempmail.com, the server fails every call.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TEMPMAIL_API_KEY`, `TEMPMAIL_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TEMPMAIL_API_KEY=<TEMPMAIL_API_KEY> --env TEMPMAIL_BASE_URL=<TEMPMAIL_BASE_URL> --transport stdio mcp-server-tempmail -- npx -y mcp-server-tempmail
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server-tempmail --env TEMPMAIL_API_KEY=<TEMPMAIL_API_KEY> --env TEMPMAIL_BASE_URL=<TEMPMAIL_BASE_URL> -- npx -y mcp-server-tempmail
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-tempmail": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-server-tempmail"
            ],
            "env": {
                "TEMPMAIL_API_KEY": "<TEMPMAIL_API_KEY>",
                "TEMPMAIL_BASE_URL": "<TEMPMAIL_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-tempmail": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-server-tempmail"
            ],
            "env": {
                "TEMPMAIL_API_KEY": "<TEMPMAIL_API_KEY>",
                "TEMPMAIL_BASE_URL": "<TEMPMAIL_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TEMPMAIL_API_KEY=<TEMPMAIL_API_KEY> -e TEMPMAIL_BASE_URL=<TEMPMAIL_BASE_URL> mcp-server-tempmail npx -y mcp-server-tempmail
```
Replace <…> with your own values

## When to use it
- automate sign-up flows and verification code extraction during tests
- create disposable inboxes directly through agent tool calls
- inspect email message bodies and headers without leaving the IDE
- configure webhook endpoints to listen for incoming mail notifications

## Example prompts
- List available domains and register a temporary email valid for 1 hour
- Fetch the message list for inbox ID c2c4f894-c672-4d5b-a918-abca95aff1f7
- Show the full body of message fd13a8df-1465-4fbc-a612-ca7311c31ff2

## Similar
- [firecrawl-monitor](https://affpapa.org/en/nevibecode/skills/firecrawl-monitor.md) — skill · 33300 installs
- [Webhook.site MCP Server](https://affpapa.org/en/nevibecode/mcp/webhooksite-mcp-server.md) — MCP server · ★ 13
- [twilio-sendgrid-inbound-parse](https://affpapa.org/en/nevibecode/skills/twilio-sendgrid-inbound-parse.md) — skill · ★ 7604
- [agent-email-cli](https://affpapa.org/en/nevibecode/skills/agent-email-cli.md) — skill · 2100 installs
- [email-testing](https://affpapa.org/en/nevibecode/skills/email-testing.md) — skill · 997 installs
- [parallel-monitor](https://affpapa.org/en/nevibecode/skills/parallel-monitor.md) — skill · 12300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md