On success, the API returns {"message_id": "...", "thread_id": "..."}. Report both to the user.
On error, report the name and message fields from the response.
Available inboxes
Email
Display Name
Use for
your-agent@agentmail.to
Parenting Assistant
Status updates, project comms
your-inbox@agentmail.to
KidPlanr
Marketing, lead outreach
API reference
List inboxes: GET https://api.agentmail.to/v0/inboxes
Send message: POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send
List messages: GET https://api.agentmail.to/v0/inboxes/{inbox_id}/messages
Notes
inbox_id in the URL must be the full email address, URL-encoded (%40 for @)
The API key from kid_camp2/backend/.env works for both inboxes (same organization)
Never log or expose the API key in output
1---2name: send-email3description: Skill: send-email4---5# Skill: send-email67Send an email from an AgentMail inbox.89## Usage1011```12/send-email --to <recipient> --from <inbox_email> --subject "<subject>" --body "<body>"13```1415## Arguments1617| Argument | Required | Default | Description |18|----------|----------|---------|-------------|19| `--to` | yes | — | Recipient email address |20| `--from` | yes | — | AgentMail inbox email (e.g. `your-agent@agentmail.to`) |21| `--subject` | yes | — | Email subject line |22| `--body` | yes | — | Plain-text email body |23| `--html` | no | — | HTML email body (overrides `--body` for HTML clients) |24| `--cc` | no | — | CC recipients (comma-separated) |25| `--reply-to` | no | — | Reply-to address |2627## How it works28291. Look up `AGENTMAIL_API_KEY` — check in order:30 - Environment variable `AGENTMAIL_API_KEY`31 - `/path/to/your/project/.env`32 - macOS Keychain: `security find-generic-password -s agentmail -w`33342. URL-encode the `--from` address for use as `{inbox_id}` in the path.35363. POST to the AgentMail API:3738```bash39INBOX_ID=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$FROM_EMAIL'))")40curl -s -X POST "https://api.agentmail.to/v0/inboxes/${INBOX_ID}/messages/send" \41 -H "Authorization: Bearer $AGENTMAIL_API_KEY" \42 -H "Content-Type: application/json" \43 -d '{44 "to": ["$TO"],45 "subject": "$SUBJECT",46 "text": "$BODY"47 }'48```49504. On success, the API returns `{"message_id": "...", "thread_id": "..."}`. Report both to the user.51525. On error, report the `name` and `message` fields from the response.5354## Available inboxes5556| Email | Display Name | Use for |57|-------|-------------|---------|58| `your-agent@agentmail.to` | Parenting Assistant | Status updates, project comms |59| `your-inbox@agentmail.to` | KidPlanr | Marketing, lead outreach |6061## API reference6263- List inboxes: `GET https://api.agentmail.to/v0/inboxes`64- Send message: `POST https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send`65- List messages: `GET https://api.agentmail.to/v0/inboxes/{inbox_id}/messages`6667## Notes6869- `inbox_id` in the URL must be the full email address, URL-encoded (`%40` for `@`)70- The API key from `kid_camp2/backend/.env` works for both inboxes (same organization)71- Never log or expose the API key in output
Run npx skillmds@latest add weizhengzhou/send-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.
Skill: send-email It is listed under Productivity on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
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.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
WeizhengZhou (@weizhengzhou) published this skill. Their other Agent Skills are listed on their SkillMD profile.