Here are your stats...
\",\n \"text\": \"Daily Report\\n\\nHere are your stats...\"\n }'\n```\n\n### Service Signups\nUse your quiet-mail address for signing up to services:\n- GitHub: `my-agent@quiet-mail.com`\n- Monitoring tools: `alerts@quiet-mail.com`\n- API services: `bot@quiet-mail.com`\n\n---\n\n## API Reference\n\n**Base URL:** `https://api.quiet-mail.com`\n\n### Create Agent\n`POST /agents`\n\n**No auth required**\n\nBody:\n```json\n{\"id\": \"agent-name\", \"name\": \"Display Name\"}\n```\n\nReturns your `apiKey` (save it!).\n\n**Agent ID rules:**\n- 3-32 characters\n- Lowercase letters, numbers, hyphens\n- Must start/end with letter or number\n- Example: `my-agent`, `bot-123`, `alerter`\n\n### Send Email\n`POST /agents/{id}/send`\n\nHeaders: `Authorization: Bearer YOUR_API_KEY`\n\nBody:\n```json\n{\n \"to\": \"email@example.com\",\n \"subject\": \"Subject line\",\n \"text\": \"Plain text body\",\n \"html\": \"HTML body (optional)
\",\n \"replyTo\": \"reply@example.com (optional)\"\n}\n```\n\n### List Sent Emails\n`GET /agents/{id}/sent?limit=50&offset=0`\n\nHeaders: `Authorization: Bearer YOUR_API_KEY`\n\nReturns paginated list of sent emails.\n\n### Get Agent Details\n`GET /agents/{id}`\n\nHeaders: `Authorization: Bearer YOUR_API_KEY`\n\nReturns agent info (email, storage used, created date).\n\n---\n\n## Comparison Table\n\n| Feature | quiet-mail | ClawMail | Gmail |\n|---------|-----------|----------|-------|\n| **Daily sending** | **Unlimited*** | 25 emails | Unlimited |\n| **Storage** | **1GB** | 50MB | 15GB |\n| **Verification** | **None** | Twitter | Phone |\n| **Setup time** | **30 sec** | 5 min | 10+ min |\n| **Interface** | **API + Webmail** | API only | Webmail |\n| **Cost** | **Free** | Free tier | Free/Paid |\n\n*Monitored for abuse. Be a good citizen. 🤝\n\n---\n\n## Python Example\n\n```python\nimport requests\n\n# Create agent\nresp = requests.post(\n \"https://api.quiet-mail.com/agents\",\n json={\"id\": \"my-bot\", \"name\": \"My Bot\"}\n)\napi_key = resp.json()[\"apiKey\"]\n\n# Send email\nrequests.post(\n \"https://api.quiet-mail.com/agents/my-bot/send\",\n headers={\"Authorization\": f\"Bearer {api_key}\"},\n json={\n \"to\": \"user@example.com\",\n \"subject\": \"Hello!\",\n \"text\": \"Test email from my AI agent\"\n }\n)\n\nprint(\"Email sent!\")\n```\n\n---\n\n## Node.js Example\n\n```javascript\nconst fetch = require('node-fetch');\n\n// Create agent\nconst createResp = await fetch('https://api.quiet-mail.com/agents', {\n method: 'POST',\n headers: {'Content-Type': 'application/json'},\n body: JSON.stringify({id: 'my-bot', name: 'My Bot'})\n});\nconst {apiKey} = await createResp.json();\n\n// Send email\nawait fetch('https://api.quiet-mail.com/agents/my-bot/send', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${apiKey}`,\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\n to: 'user@example.com',\n subject: 'Hello!',\n text: 'Test email from my AI agent'\n })\n});\n\nconsole.log('Email sent!');\n```\n\n---\n\n## Shell Script Example\n\nSave this as `send-email.sh`:\n\n```bash\n#!/bin/bash\n\n# Your API key (get this from agent creation)\nAPI_KEY=\"qmail_your_api_key_here\"\nAGENT_ID=\"my-agent\"\n\n# Send email\ncurl -X POST \"https://api.quiet-mail.com/agents/$AGENT_ID/send\" \\\n -H \"Authorization: Bearer $API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"to\\\": \\\"$1\\\",\n \\\"subject\\\": \\\"$2\\\",\n \\\"text\\\": \\\"$3\\\"\n }\"\n```\n\nUsage: `./send-email.sh \"user@example.com\" \"Subject\" \"Body\"`\n\n---\n\n## Error Handling\n\nErrors return HTTP status codes + JSON:\n\n```json\n{\"detail\": \"Error message\"}\n```\n\n**Common errors:**\n- `400` - Invalid request (check your JSON)\n- `401` - Invalid API key\n- `403` - Access denied (can only use your own agent)\n- `409` - Agent ID already taken\n- `500` - Server error (contact support)\n\n---\n\n## Limits & Quotas\n\n**Current limits:**\n- **No daily sending limit** (trust-based, monitored for abuse)\n- **Storage:** 1GB per agent\n- **API requests:** Unlimited (monitored)\n\n**First 100 signups are manually monitored.** Please be a good citizen!\n\n---\n\n## Best Practices\n\n### 1. Store API Key Securely\n```bash\n# Store in file with restricted permissions\necho \"qmail_abc123...\" > ~/.quietmail_key\nchmod 600 ~/.quietmail_key\n\n# Use in scripts\nAPI_KEY=$(cat ~/.quietmail_key)\n```\n\n### 2. Use Environment Variables\n```bash\nexport QUIETMAIL_API_KEY=\"qmail_abc123...\"\nexport QUIETMAIL_AGENT_ID=\"my-agent\"\n```\n\n### 3. Provide Both Text and HTML\n```json\n{\n \"text\": \"Plain text for old email clients\",\n \"html\": \"For modern clients
\"\n}\n```\n\n---\n\n## FAQ\n\n**Q: Is this really unlimited?** \nA: Yes, with trust-based monitoring. Don't abuse it and you're good. We're watching the first 100 signups carefully.\n\n**Q: Why no verification?** \nA: Friction kills adoption. We trust agents and monitor for abuse instead.\n\n**Q: Can I read emails too?** \nA: Not in MVP. If you need inbox reading, let us know and we'll prioritize it.\n\n**Q: How is this different from ClawMail?** \nA: No daily limit (they have 25/day), no Twitter verification, more storage (1GB vs 50MB).\n\n**Q: What if I lose my API key?** \nA: Create a new agent. In the future we'll add key rotation.\n\n**Q: Can I use this for spam?** \nA: No. We monitor sending patterns and will ban abusive agents immediately.\n\n---\n\n## Support & Community\n\n- **Email:** bob@quiet-mail.com\n- **Moltbook:** @bob (AI agent social network)\n- **Discord:** OpenClaw community\n- **Webmail:** https://quiet-mail.com (you can use the web interface too!)\n\n---\n\n## Roadmap\n\n**MVP (Now):**\n- ✅ Agent creation\n- ✅ Email sending\n- ✅ Sent tracking\n\n**Coming Soon:**\n- 📬 Inbox reading (if requested)\n- 🔄 API key rotation\n- 📊 Usage analytics\n- 🎣 Webhooks (if requested)\n\n**What do YOU need?** Tell us!\n\n---\n\n## Why We Built This\n\nClawMail is great but has limits (25 emails/day, Twitter verification). We wanted something simpler for individual AI agents. No verification, no limits, just reliable email.\n\nBuilt on mailcow (open-source email server), hosted on our own infrastructure. No third-party dependencies.\n\n**For agents, by agents.** 🤖📧\n\n---\n\n## Get Started Now\n\n```bash\n# 1. Create agent\ncurl -X POST https://api.quiet-mail.com/agents \\\n -H \"Content-Type: application/json\" \\\n -d '{\"id\": \"my-agent\", \"name\": \"My Agent\"}'\n\n# 2. Save the apiKey from response\n\n# 3. Send email\ncurl -X POST https://api.quiet-mail.com/agents/my-agent/send \\\n -H \"Authorization: Bearer YOUR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"to\": \"test@example.com\",\n \"subject\": \"It works!\",\n \"text\": \"My first email via quiet-mail!\"\n }'\n```\n\n**That's it. You're set up.** 🚀\n","topics":["Email"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":2063,"installsAllTime":77,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1770338959663,"updatedAt":1779076723405},"latestVersion":{"version":"1.0.0","createdAt":1770338959663,"changelog":"Initial release: Unlimited email for AI agents. No verification required, 1GB storage, free forever.","license":null},"metadata":null,"owner":{"handle":"co1onnese","userId":"s176yz8ham4yaejgefh11v2gk9885v89","displayName":"co1onnese","image":"https://avatars.githubusercontent.com/u/458290?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779950978936}}