Use temporary email directly inside your AI agent
Install the ChatTempMail skill once, then ask Cursor, Claude Code, Codex, OpenClaw, or another agent to create temp emails, read verification codes, and manage inboxes for you.
Use with AI Agents — Zero Setup
Copy this prompt and paste it into your AI coding agent. The agent handles npm, GitHub, and local skill setup details for you.
Install the ChatTempMail temp-email skill for my AI agent. Use the npm package temp-email-skill or the GitHub repo https://github.com/Selenium39/temp-email-skill, then configure TEMP_EMAIL_API_KEY with my ChatTempMail API key. After installation, use the skill to create temporary emails, check inbox messages, read verification codes, and manage webhooks.Create disposable emails
Ask your agent for a fresh address, expiration time, or a specific domain.
Read inbox messages
Let the agent fetch messages and extract verification codes during sign-up flows.
Configure webhooks
Push new-message events to your app or test server without writing API glue first.
Keep real inboxes private
Use temporary addresses for product testing, QA, and third-party trials.
Installation methods
Start with the agent prompt if you do not want to touch npm or GitHub. The manual options are here for teams that prefer explicit setup.
AI Agent Prompt
Best for most users. Paste it into Cursor, Claude Code, Codex, OpenClaw, Windsurf, or another coding agent.
Install the ChatTempMail temp-email skill for my AI agent. Use the npm package temp-email-skill or the GitHub repo https://github.com/Selenium39/temp-email-skill, then configure TEMP_EMAIL_API_KEY with my ChatTempMail API key. After installation, use the skill to create temporary emails, check inbox messages, read verification codes, and manage webhooks.NPM Package
For developers who want the package in a local project or shared toolchain.
npm install temp-email-skillGitHub Skill
For agents that install skills directly from repositories.
/plugin install Selenium39/temp-email-skillBefore your agent can use the skill
Create an API key in your ChatTempMail profile, then give it to your agent as an environment variable. The skill uses the same REST API as the dashboard and MCP Server.
Environment variable
The skill expects this key name.
export TEMP_EMAIL_API_KEY="your-api-key"Pick the right integration
The skill is the easiest path for agent users. MCP Server and REST API remain available when you need protocol-level or application-level control.
Agent Skill
Best for users who want to paste one prompt and let the AI agent install and use temporary email workflows.
MCP Server
Best when your AI tool supports Model Context Protocol and you want structured tool calls.
View MCP ServerREST API
Best for product integrations, backends, automation scripts, and direct HTTP calls.
View API Docs