temp-email-mcp

MCP server for SmailPro — access temporary Gmail, Temp Outlook, and custom-domain temporary email addresses seamlessly via AI assistants (Claude, Cursor, Windsurf, etc.).

Features

• 🔴 Temp Gmail — Instant access to a pool of 5,000+ real Gmail addresses
• 🔵 Temp Outlook — Instant access to a pool of 3,000+ real Outlook addresses
• 📧 Temp Mail — Instantly generate temporary emails with custom domains (20+ available)
• 🔑 API key authentication via my.sonjj.com

---

Prerequisites

1. Create an account at my.sonjj.com to get your API key
2. Purchase credits: SonjJ API Credits Guide

---

Quick Start

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "smailpro": {
      "command": "npx",
      "args": ["-y", "temp-email-mcp"],
      "env": {
        "SMAILPRO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "smailpro": {
      "command": "npx",
      "args": ["-y", "temp-email-mcp"],
      "env": {
        "SMAILPRO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "smailpro": {
      "command": "npx",
      "args": ["-y", "temp-email-mcp"],
      "env": {
        "SMAILPRO_API_KEY": "your-api-key-here"
      }
    }
  }
}

---

Configuration

Variable	Required	Description
SMAILPRO_API_KEY	✅ Yes	Your API key from my.sonjj.com

---

Available Tools (12)

📧 TempMailAPI — Custom Domain Email

Tool	Description
temp_mail_get_domains	Get list of available email domains
temp_mail_create	Create a temporary email address
temp_mail_get_inbox	Check inbox for a temporary email
temp_mail_get_message	Read full content of a specific message

🔴 TempGmailAPI — Gmail Pool

Tool	Description
temp_gmail_list	List available Gmail addresses (paginated)
temp_gmail_random	Get a random Gmail address instantly
temp_gmail_get_inbox	Check Gmail inbox (filter by timestamp)
temp_gmail_get_message	Read full content of a Gmail message
temp_gmail_remove_message	Remove a message from Gmail inbox (beta)

🔵 TempOutlookAPI — Outlook Pool

Tool	Description
temp_outlook_list	List available Outlook addresses (paginated)
temp_outlook_get_inbox	Check Outlook inbox (filter by timestamp)
temp_outlook_get_message	Read full content of an Outlook message

---

Credits Cost Per Call

Tool	Credits
temp_mail_get_domains	1.00
temp_mail_create	1.00
temp_mail_get_inbox	0.05
temp_mail_get_message	1.00
temp_gmail_list	2.00
temp_gmail_random	0.50
temp_gmail_get_inbox	0.05
temp_gmail_get_message	1.50
temp_gmail_remove_message	free
temp_outlook_list	2.00
temp_outlook_get_inbox	0.05
temp_outlook_get_message	2.00

---

Example Usage in Claude

Create a temporary Gmail for me and check if any emails arrived.

Claude will automatically:

1. Call temp_gmail_random to get a Gmail address
2. Wait, then call temp_gmail_get_inbox with the returned timestamp
3. Call temp_gmail_get_message to read message content if any arrived

---

Links

• 🌐 smailpro.com
• 📖 API Docs
• 🔑 Get API Key
• 💳 Credits Guide