# Temp Mail

> Lets your agent create temporary email addresses and read what arrives, for testing sign-up emails or keeping your real address private.

Temp Mail's own hosted MCP server connects its API to your agent, so you can ask in plain words for a temporary email address and read the messages that arrive. Temp Mail (temp-mail.io) makes disposable inboxes that keep your real address away from spam, and developers use them to test email features without a pile of test accounts.

What you can do with it
- Create a temporary email address on Temp Mail's domains
- Check an address for new messages, and read them
- Pick up the confirmation link or code while you test your own app's sign-up and verification emails
- Keep your real inbox out of newsletters, trials and one-off downloads

How it connects
Add https://api.temp-mail.io/v1/mcp as a remote (streamable HTTP) server. There's no API key to paste: the first time your agent connects, your browser opens to sign in to Temp Mail and approve access, and the token refreshes itself after that. Temp Mail's guide covers Claude Code, Codex, Gemini CLI, Cursor, VS Code with GitHub Copilot and more.

Good to know
- You need an active Temp Mail Premium account to authorize the server.
- Addresses only receive mail; you can't send from them.
- Addresses expire after a while, and Temp Mail warns against using them for anything important, such as bank accounts.

- Type: Plugin
- Made by: Temp Mail
- Category: Communication
- Formats: Remote MCP
- Version: 1.0.1
- Website: https://docs.temp-mail.io/docs/mcp-server
- Page: https://pluginboard.ai/plugins/temp-mail

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://api.temp-mail.io/v1/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://api.temp-mail.io/v1/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://api.temp-mail.io/v1/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://api.temp-mail.io/v1/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://api.temp-mail.io/v1/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://api.temp-mail.io/v1/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22temp-mail%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.temp-mail.io%2Fv1%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http temp-mail https://api.temp-mail.io/v1/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=temp-mail&config=eyJ1cmwiOiJodHRwczovL2FwaS50ZW1wLW1haWwuaW8vdjEvbWNwIn0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "temp-mail": {
      "url": "https://api.temp-mail.io/v1/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http temp-mail https://api.temp-mail.io/v1/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add temp-mail --url https://api.temp-mail.io/v1/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "temp-mail": {
      "url": "https://api.temp-mail.io/v1/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http temp-mail https://api.temp-mail.io/v1/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://api.temp-mail.io/v1/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add temp-mail --url https://api.temp-mail.io/v1/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://api.temp-mail.io/v1/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login temp-mail.

### OpenCode

Run in your terminal:

```shell
opencode mcp add temp-mail --url https://api.temp-mail.io/v1/mcp
```

If it needs a key: For https://api.temp-mail.io/v1/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add temp-mail --url https://api.temp-mail.io/v1/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "temp-mail": {
      "url": "https://api.temp-mail.io/v1/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://api.temp-mail.io/v1/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).