How do I install the Temp Email skill?

Run npx skillmds@latest add vesely/temp-email in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Temp Email safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Temp Email?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Temp Email free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Temp Email?

vesely (@vesely) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Temp Email by vesely — Agent Skill

Name: Temp Email
Author: vesely

Temp Email

Create and manage temporary/disposable email inboxes via tempmail.lol API (no dependencies, just curl). Use whenever the user needs a throwaway email — E2E testing, account registration, email verification, OTP confirmation, or any disposable inbox scenario. Triggers on: "temp email", "temporary email", "disposable email", "dočasný email", "dočasná schránka", "throwaway email", "fake email for testing", or when a task implies needing a temporary email (e.g. "sign up for X and verify", "test the registration flow").

vesely a4e204f 2 files · 2.5 KB Updated Sep 17, 2026

File contents

Temporary Email (tempmail.lol)

Disposable email inboxes via curl. No dependencies, no API key. Domains rotate automatically so addresses are unlikely to be blocklisted.

Create inbox

INBOX=$(curl -s -X POST https://api.tempmail.lol/v2/inbox/create)
EMAIL=$(echo "$INBOX" | jq -r .address)
TOKEN=$(echo "$INBOX" | jq -r .token)
echo "Email: $EMAIL"

Save both EMAIL and TOKEN — you need the token to check messages.

Check messages

curl -s "https://api.tempmail.lol/v2/inbox?token=$TOKEN" | jq

Returns {"emails": [...], "expired": false}. Each email has from, subject, body (HTML), and date.

Poll for a message (wait up to 60s)

for i in $(seq 1 12); do
  MSGS=$(curl -s "https://api.tempmail.lol/v2/inbox?token=$TOKEN")
  COUNT=$(echo "$MSGS" | jq '.emails | length')
  if [ "$COUNT" -gt 0 ]; then
    echo "$MSGS" | jq '.emails'
    break
  fi
  [ $i -lt 12 ] && sleep 5
done

Extract verification link or OTP

After receiving a message, parse the body field (HTML):

Verification URLs: grep for href= containing verify, confirm, activate, token=, code=, magic, login
OTP codes: look for standalone 4-8 digit numbers near words like "code", "kód", "verification"

# Example: extract first URL with verify/confirm
echo "$MSGS" | jq -r '.emails[0].body' | grep -oP 'href="[^"]*(?:verify|confirm|activate|token=|code=)[^"]*"'

Notes

Domains rotate (hush2u.com, leadharbor.org, cloudvxz.com, etc.) — never hardcode them.
Inboxes expire after ~10 minutes of inactivity.
For E2E tests: create at test start, poll during verification step, no explicit cleanup needed (auto-expires).

---name: temp-emaildescription: Create and manage temporary/disposable email inboxes via tempmail.lol API (no dependencies, just curl). Use whenever the user needs a throwaway email — E2E testing, account registration, email verification, OTP confirmation, or any disposable inbox scenario. Triggers on: "temp email", "temporary email", "disposable email", "dočasný email", "dočasná schránka", "throwaway email", "fake email for testing", or when a task implies needing a temporary email (e.g. "sign up for X and verify", "test the registration flow").---# Temporary Email (tempmail.lol)Disposable email inboxes via `curl`. No dependencies, no API key. Domains rotate automatically so addresses are unlikely to be blocklisted.## Create inbox```bashINBOX=$(curl -s -X POST https://api.tempmail.lol/v2/inbox/create)EMAIL=$(echo "$INBOX" | jq -r .address)TOKEN=$(echo "$INBOX" | jq -r .token)echo "Email: $EMAIL"```Save both `EMAIL` and `TOKEN` — you need the token to check messages.## Check messages```bashcurl -s "https://api.tempmail.lol/v2/inbox?token=$TOKEN" | jq```Returns `{"emails": [...], "expired": false}`. Each email has `from`, `subject`, `body` (HTML), and `date`.## Poll for a message (wait up to 60s)```bashfor i in $(seq 1 12); do MSGS=$(curl -s "https://api.tempmail.lol/v2/inbox?token=$TOKEN") COUNT=$(echo "$MSGS" | jq '.emails | length') if [ "$COUNT" -gt 0 ]; then echo "$MSGS" | jq '.emails' break fi [ $i -lt 12 ] && sleep 5done```## Extract verification link or OTPAfter receiving a message, parse the `body` field (HTML):- **Verification URLs**: grep for `href=` containing `verify`, `confirm`, `activate`, `token=`, `code=`, `magic`, `login`- **OTP codes**: look for standalone 4-8 digit numbers near words like "code", "kód", "verification"```bash# Example: extract first URL with verify/confirmecho "$MSGS" | jq -r '.emails[0].body' | grep -oP 'href="[^"]*(?:verify|confirm|activate|token=|code=)[^"]*"'```## Notes- Domains rotate (hush2u.com, leadharbor.org, cloudvxz.com, etc.) — never hardcode them.- Inboxes expire after ~10 minutes of inactivity.- For E2E tests: create at test start, poll during verification step, no explicit cleanup needed (auto-expires).

Frequently asked questions