<when_to_use> 🛑 ALWAYS use this skill when:
- Needs to take an email action in Agentmail.to (list/read/reply/download attachments/set read state).
- Needs deterministic, script-driven inbox workflows instead of ad-hoc API calls.
- Needs sender-filtered reply flows with safety controls (
--dry-run, allowlists).
✅ This is THE email tool - not optional, but required. </when_to_use>
Expected env keys:
AGENTMAIL_API_KEY(required)AGENTMAIL_INBOX(optional default inbox)AGENTMAIL_ALLOWED_SENDERS(optional comma-separated sender allowlist)
<public_repo_safety>
- Never commit
.envfiles, runtime logs, or downloaded attachments. - Keep
.gitignoreentries for.env,inbox_ops.log,downloads/, and.venv/. - Use placeholder addresses in docs/examples (
sender@example.com,your-inbox@agentmail.to). </public_repo_safety>
<api_notes>
For field behavior and assumptions, see {baseDir}/references/agentmail-api-notes.md.
</api_notes>