ariffazil/agentmail
skills/agentmail/SKILL.md
Give Hermes its own email inbox. Send, receive, and manage email autonomously via agent-owned email addresses ([email protected]). Use when you need to send emails, receive replies, manage email threads, sign up for services via email, or communicate with other agents/humans via email.
data-ai
Updated May 1, 2026
$ install --global
skillsauthnpx skillsauth add ariffazil/openclaw-workspace agentmailInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 4:08 AM48.7s2 files scanned
SKILL.md
- name:
- agentmail
- description:
- Give Hermes its own email inbox. Send, receive, and manage email autonomously via agent-owned email addresses ([email protected]). Use when you need to send emails, receive replies, manage email threads, sign up for services via email, or communicate with other agents/humans via email.
- tags:
- [email, communication, agentmail, mcp]
- version:
- 1.0.0
- author:
- Hermes / arifOS AAA
- license:
- MIT
AgentMail — Agent-Owned Email Inbox
Quick Start
- Create inbox:
create_inbox(username="hermes-agent")→ gets[email protected] - Send:
send_message(inbox_id=..., to=recipient, subject=..., text=...) - Check replies:
list_threads(inbox_id=...)→get_thread(thread_id=...) - Reply:
reply_to_message(message_id=..., text=...)
Available Tools
| Tool | Description |
|------|-------------|
| list_inboxes | List all agent inboxes |
| get_inbox | Get details of a specific inbox |
| create_inbox | Create a new inbox (gets real email address) |
| delete_inbox | Delete an inbox |
| list_threads | List email threads in an inbox |
| get_thread | Get a specific email thread with all messages |
| send_message | Send a new email |
| reply_to_message | Reply to an existing email |
| forward_message | Forward an email |
| update_message | Update message labels/status |
| get_attachment | Download an email attachment |
Configuration
The MCP server is configured in ~/.hermes/config.yaml under mcp.servers.
API key is set via environment variable AGENTMAIL_API_KEY.
Workflows
Send an email
create_inboxif no inbox exists yetsend_message(inbox_id, to=email, subject=subject, text=body)
Check for replies
list_inboxes→ get inbox_idlist_threads(inbox_id=inbox_id)→ list conversation threadsget_thread(thread_id=thread_id)→ read full thread
Reply to an email
get_threadto find the message_idreply_to_message(message_id=msg_id, text=reply_text)
Sign up for a service
create_inbox(username="signup-bot")→ gets inbox address- Use the inbox address to register on the service
list_threadsto check for verification emailget_threadto read the verification code
Constitutional Notes
- F01 AMANAH: No irreversible email deletion without 888_HOLD
- F04 CLARITY: State purpose of email in subject line
- F05 PEACE: No harmful or abusive content
- F12 INJECTION: Sanitize all email inputs (no raw HTML injection)
Limitations
- Free tier: 3 inboxes, 3,000 emails/month
- Free tier sends from @agentmail.to domain only
- Real-time inbound: use
list_threadspolling via cronjob
Verification
Use list_inboxes to confirm the MCP connection is working.
Related Skills
ariffazil/XAUUSD-trading-stack
development
VerifiedTrustedCommunity
Federation-wide gold (XAUUSD) trading capability. Python stack, OANDA broker, backtesting, macro signals, RSI strategy. Every organ has a role.
2SKILL.mdUpdated Jul 24, 2026
ariffazil/wealth-claim-state
development
VerifiedTrustedCommunity
Capital claim state management — tracks claim lifecycle across WEALTH organ.
2SKILL.mdUpdated Jul 24, 2026
ariffazil/warga-constitutional
development
VerifiedTrustedCommunity
Archived constitutional warga placeholder retained only for audit provenance. Do not use for active work; use the live arifOS governance and constitutional skills instead.
2SKILL.mdUpdated Jul 24, 2026
ariffazil/warga
testing
VerifiedTrustedCommunity
Warga (citizen) agent skills for AAA federation members. See subdirectories for specialized warga skills.
2SKILL.mdUpdated Jul 24, 2026