Skip to main content
plugin CX Codex

mailagent — Claude Code and Codex plugin: temp inboxes for OTP

mailagent hands the agent throwaway inboxes so it can read verification codes and magic links, finish a signup check, then clean up.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mailagent@awesome-codex-plugins
Open on GitHub

What mailagent does

The plugin wires MailAgent's MCP server into your agent. That server opens a temporary mailbox, waits for the message and pulls out the confirmation code or the magic link. A test signup then runs end to end without anyone copying mail by hand.

The bundle ships scripts/run-mailagent-mcp.sh, which starts the stdio package @mailagent/[email protected] through npx, plus a .env.example template. Secrets belong in .env; the API address defaults to https://api.webmailagent.com. The server exposes 23 tools. To confirm the connection, run codex mcp list and look for mailagent_plan_next, mailagent_verify_signup and mailagent_create_inbox.

You need MAILAGENT_API_KEY, either in .env or inherited from the parent process. Without it the server cannot authenticate. Keep the key out of logs and chat. A remote OAuth route also exists at https://api.webmailagent.com/mcp with a short-lived mat_ token, which drops the local subprocess.

What it helps with

  • read the OTP out of a signup email
  • grab a magic link and follow it
  • run a signup flow without touching a real mailbox
  • wait for a message matching a subject line
  • delete the throwaway inbox once the test ends

Example prompts for the agent

  • Create an inbox with mailagent_create_inbox, label it signup-test, and put the address into the signup form.
  • Wait for the mail with Verify in the subject through mailagent_wait_and_extract and pull the otp field.
  • Clean up with mailagent_delete_inbox after the account is created.

How to install mailagent

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mailagent@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about mailagent

How do I install mailagent in Claude Code?

Add the marketplace with /plugin marketplace add hashgraph-online/awesome-codex-plugins, then install the plugin: /plugin install mailagent@awesome-codex-plugins.

What does mailagent do?

It gives the agent temporary inboxes: create one, wait for the mail with a code or magic link, extract the value, delete the inbox. The mailagent_verify_signup call does the wait and extract in a single step.

Does mailagent need an API key?

Yes, MAILAGENT_API_KEY goes into .env or comes from the parent process environment; the API address defaults to https://api.webmailagent.com. The OAuth route instead takes a short-lived mat_ token.

Source text

MailAgent · MIT
# MailAgent Codex Plugin

MailAgent gives Codex temporary inboxes for signup QA, OTP emails, and magic links.

## Setup

```bash
cp .env.example .env
chmod +x scripts/run-mailagent-mcp.sh
```

Put secrets in `.env` (gitignored). `MAILAGENT_API_URL` defaults to `https://api.webmailagent.com`.
`MAILAGENT_API_KEY` may also come from the parent process environment. Do not log or paste the key.

```dotenv
MAILAGENT_API_URL=https://api.webmailagent.com
MAILAGENT_API_KEY=ma_or_mak_replace_me
```

## Check MCP

The plugin launches the published npm stdio package via `scripts/run-mailagent-mcp.sh`:

```bash
codex mcp list
```

Expected: `mailagent` server with `mailagent_plan_next`, `mailagent_verify_signup`, and `mailagent_create_inbox`.

## Verify signup flow

1. If unsure, call `mailagent_plan_next` and follow `nextTool` / `nextPayload`.
2. `mailagent_create_inbox` with `label` and `service`.
3. Submit returned `address` in the signup form.
4. `mailagent_wait_and_extract` with `inboxId` and `subjectContains`.
5. Use `otp` or `primaryLink` to finish signup.
6. `mailagent_delete_inbox` for cleanup.

If the form is already submitted, use `mailagent_verify_signup` to wait and extract in one call.

## Remote MCP (OAuth)

For Streamable HTTP without a local subprocess, see
[OAuth IdP docs](https://webmailagent.com/docs/oauth-idp.html) and use `https://api.webmailagent.com/mcp`
with a short-lived `mat_` bearer token.

This bundle keeps stdio MCP via `npx -y -p @mailagent/[email protected] mailagent-mcp`.

## Install from GitHub marketplace

```bash
codex plugin marketplace add Alex0nder/MailAgent
codex plugin add mailagent@mailagent
```

Docs: https://webmailagent.com/docs/codex.html

© MailAgent · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Testing and QA →

From the same set391

The whole set →
ml-pipeline The ml-pipeline plugin makes an agent follow a 16-step, data-first ML workflow before training. It fits tasks where premature .fit() calls could compromise the analysis. CX Codex ★ 1,596repo stars memoire memoire keeps a picture of your design system where the agent can reach it: interface checks, Tailwind tokens pulled from existing markup, and shadcn registry work. CX Codex ★ 1,596repo stars codex-multiple-env codex-multiple-env isolates ChatGPT accounts and workspaces for Codex CLI into separate CODEX_HOME folders. Switches profiles without repeated logouts. CX Codex ★ 1,596repo stars mcp-md-reader The mcp-md-reader plugin lets an agent navigate Markdown structure and fetch only the needed section. It fits large files and linked note vaults. CX Codex ★ 1,596repo stars magents magents connects Codex, Claude, and Cursor through a shared MCP session bus. Useful when handing off context or spawning tasks across tools without copy-pasting. CX Codex ★ 1,596repo stars maestro maestro sends a prompt to several local model CLIs, then has a judge compare their answers and a synthesizer produce a grounded result. Use it when you want one considered response from a model panel. CX Codex ★ 1,596repo stars lvtd-skills lvtd-skills is a plugin for Claude Code and Codex with ready-made agent skills for Django, htmx, Rust, developer docs, SEO, traction and nonfiction books, one SKILL.md per topic. CX Codex ★ 1,596repo stars krypton krypton is a Claude Code and Codex plugin that turns development requests into plans with owners, cutover decisions, and acceptance evidence. Use it for feature work, bug fixes, refactors, migrations, and architecture goals. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open