How do I install the Lumbox skill?

Run npx skillmds@latest add kumard3/lumbox 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 Lumbox 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 Lumbox?

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 Lumbox free to use?

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

Who published Lumbox?

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

Lumbox by kumard3 — Agent Skill

Name: Lumbox
Author: kumard3

Lumbox

Give an AI agent its own email - create inboxes, send and receive email, wait for OTP codes, all self-service with no human signup. Use when an agent needs an email address to sign up for services, receive verification codes, or manage correspondence.

kumard3 4b95d70 2.0 KB Updated Sep 17, 2026

File contents

Lumbox - email for AI agents

Lumbox gives agents real email inboxes via CLI, REST API, or MCP. An agent can provision itself with no human account creation.

Self-signup (no human needed)

CLI (requires Node 18+):

npx lumbox signup --source <your-harness-name>

This creates an org + API key and saves it to ~/.lumbox/config.json. Or via curl:

curl -X POST https://api.lumbox.co/v1/orgs \
  -H 'Content-Type: application/json' \
  -d '{"name": "my-agent-org", "source": "skill"}'

Save the returned api_key (shown only once). Export it as LUMBOX_API_KEY. Free tier: 3 inboxes, 500 inbound + 100 outbound emails/month. Self-signup is rate-limited to 3 orgs/hour per IP.

Core flows (CLI)

npx lumbox inbox create --name assistant
npx lumbox send --inbox <id> --to a@b.com --subject "Hi" --text "Hello"
npx lumbox wait-otp --inbox <id> --timeout 120

inbox create returns {id, address}; wait-otp blocks until an OTP arrives and prints the parsed code. All CLI output is JSON.

Core flows (REST)

POST /v1/inboxes                  create inbox
GET  /v1/inboxes/:id/wait         long-poll for next email (120s)
GET  /v1/inboxes/:id/otp          long-poll for OTP, returns parsed code
POST /v1/inboxes/:id/send         send email
POST /v1/inboxes/:id/reply        reply in thread

Auth: Authorization: Bearer $LUMBOX_API_KEY. Base URL: https://api.lumbox.co.

Full toolset (MCP, 87 tools)

claude mcp add lumbox -- npx @lumbox/mcp-server

or HTTP MCP at https://mcp.lumbox.co with the same Bearer key. Includes browser automation, credential vault, webhooks, custom domains, contact lists.

Docs: https://docs.lumbox.co • Agent guide: https://docs.lumbox.co/docs/agent-signup

---name: lumboxdescription: Give an AI agent its own email - create inboxes, send and receive email, wait for OTP codes, all self-service with no human signup. Use when an agent needs an email address to sign up for services, receive verification codes, or manage correspondence.---# Lumbox - email for AI agentsLumbox gives agents real email inboxes via CLI, REST API, or MCP. An agent can provisionitself with no human account creation.## Self-signup (no human needed)CLI (requires Node 18+): npx lumbox signup --source <your-harness-name>This creates an org + API key and saves it to `~/.lumbox/config.json`. Or via curl: curl -X POST https://api.lumbox.co/v1/orgs \ -H 'Content-Type: application/json' \ -d '{"name": "my-agent-org", "source": "skill"}'Save the returned `api_key` (shown only once). Export it as `LUMBOX_API_KEY`.Free tier: 3 inboxes, 500 inbound + 100 outbound emails/month. Self-signup is rate-limitedto 3 orgs/hour per IP.## Core flows (CLI) npx lumbox inbox create --name assistant npx lumbox send --inbox <id> --to a@b.com --subject "Hi" --text "Hello" npx lumbox wait-otp --inbox <id> --timeout 120`inbox create` returns `{id, address}`; `wait-otp` blocks until an OTP arrives and printsthe parsed code. All CLI output is JSON.## Core flows (REST) POST /v1/inboxes create inbox GET /v1/inboxes/:id/wait long-poll for next email (120s) GET /v1/inboxes/:id/otp long-poll for OTP, returns parsed code POST /v1/inboxes/:id/send send email POST /v1/inboxes/:id/reply reply in threadAuth: `Authorization: Bearer $LUMBOX_API_KEY`. Base URL: `https://api.lumbox.co`.## Full toolset (MCP, 87 tools) claude mcp add lumbox -- npx @lumbox/mcp-serveror HTTP MCP at `https://mcp.lumbox.co` with the same Bearer key. Includes browserautomation, credential vault, webhooks, custom domains, contact lists.Docs: https://docs.lumbox.co • Agent guide: https://docs.lumbox.co/docs/agent-signup

Frequently asked questions