Source Code

quiet-mail - Email for AI Agents

Unlimited email for AI agents. No verification, no limits, just reliable email.

Quick Start (60 seconds)

1. Create Your Agent

curl -X POST https://api.quiet-mail.com/agents \
  -H "Content-Type: application/json" \
  -d '{"id": "my-agent", "name": "My AI Assistant"}'

Response:

{
  "agent": {
    "id": "my-agent",
    "email": "my-agent@quiet-mail.com",
    "createdAt": 1738789200000
  },
  "apiKey": "qmail_abc123...",
  "message": "Store your API key securely"
}

⚠️ Save your apiKey! You'll need it for all requests.

2. Send Your First Email

curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer qmail_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "subject": "Hello from my AI agent!",
    "text": "This is my first email sent via quiet-mail API."
  }'

Done! Your email is sent. 📧

3. Check Sent Emails

curl https://api.quiet-mail.com/agents/my-agent/sent \
  -H "Authorization: Bearer qmail_abc123..."

Use Cases

Send Notifications

curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Task Complete",
    "text": "Your automation finished successfully!"
  }'

Send HTML Emails

curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Daily Report",
    "html": "<h1>Daily Report</h1><p>Here are your stats...</p>",
    "text": "Daily Report\n\nHere are your stats..."
  }'

Service Signups

Use your quiet-mail address for signing up to services:

GitHub: my-agent@quiet-mail.com
Monitoring tools: alerts@quiet-mail.com
API services: bot@quiet-mail.com

API Reference

Base URL: https://api.quiet-mail.com

Create Agent

POST /agents

No auth required

Body:

{"id": "agent-name", "name": "Display Name"}

Returns your apiKey (save it!).

Agent ID rules:

3-32 characters
Lowercase letters, numbers, hyphens
Must start/end with letter or number
Example: my-agent, bot-123, alerter

Send Email

POST /agents/{id}/send

Headers: Authorization: Bearer YOUR_API_KEY

Body:

{
  "to": "email@example.com",
  "subject": "Subject line",
  "text": "Plain text body",
  "html": "<p>HTML body (optional)</p>",
  "replyTo": "reply@example.com (optional)"
}

List Sent Emails

GET /agents/{id}/sent?limit=50&offset=0

Headers: Authorization: Bearer YOUR_API_KEY

Returns paginated list of sent emails.

Get Agent Details

GET /agents/{id}

Headers: Authorization: Bearer YOUR_API_KEY

Returns agent info (email, storage used, created date).

Comparison Table

Feature	quiet-mail	ClawMail	Gmail
Daily sending	Unlimited*	25 emails	Unlimited
Storage	1GB	50MB	15GB
Verification	None	Twitter	Phone
Setup time	30 sec	5 min	10+ min
Interface	API + Webmail	API only	Webmail
Cost	Free	Free tier	Free/Paid

*Monitored for abuse. Be a good citizen. 🤝

Python Example

import requests

# Create agent
resp = requests.post(
    "https://api.quiet-mail.com/agents",
    json={"id": "my-bot", "name": "My Bot"}
)
api_key = resp.json()["apiKey"]

# Send email
requests.post(
    "https://api.quiet-mail.com/agents/my-bot/send",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "to": "user@example.com",
        "subject": "Hello!",
        "text": "Test email from my AI agent"
    }
)

print("Email sent!")

Node.js Example

const fetch = require('node-fetch');

// Create agent
const createResp = await fetch('https://api.quiet-mail.com/agents', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({id: 'my-bot', name: 'My Bot'})
});
const {apiKey} = await createResp.json();

// Send email
await fetch('https://api.quiet-mail.com/agents/my-bot/send', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: 'user@example.com',
    subject: 'Hello!',
    text: 'Test email from my AI agent'
  })
});

console.log('Email sent!');

Shell Script Example

Save this as send-email.sh:

#!/bin/bash

# Your API key (get this from agent creation)
API_KEY="qmail_your_api_key_here"
AGENT_ID="my-agent"

# Send email
curl -X POST "https://api.quiet-mail.com/agents/$AGENT_ID/send" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"to\": \"$1\",
    \"subject\": \"$2\",
    \"text\": \"$3\"
  }"

Usage: ./send-email.sh "user@example.com" "Subject" "Body"

Error Handling

Errors return HTTP status codes + JSON:

{"detail": "Error message"}

Common errors:

400 - Invalid request (check your JSON)
401 - Invalid API key
403 - Access denied (can only use your own agent)
409 - Agent ID already taken
500 - Server error (contact support)

Limits & Quotas

Current limits:

No daily sending limit (trust-based, monitored for abuse)
Storage: 1GB per agent
API requests: Unlimited (monitored)

First 100 signups are manually monitored. Please be a good citizen!

Best Practices

1. Store API Key Securely

# Store in file with restricted permissions
echo "qmail_abc123..." > ~/.quietmail_key
chmod 600 ~/.quietmail_key

# Use in scripts
API_KEY=$(cat ~/.quietmail_key)

2. Use Environment Variables

export QUIETMAIL_API_KEY="qmail_abc123..."
export QUIETMAIL_AGENT_ID="my-agent"

3. Provide Both Text and HTML

{
  "text": "Plain text for old email clients",
  "html": "<h1>Rich HTML</h1><p>For modern clients</p>"
}

FAQ

Q: Is this really unlimited?
A: Yes, with trust-based monitoring. Don't abuse it and you're good. We're watching the first 100 signups carefully.

Q: Why no verification?
A: Friction kills adoption. We trust agents and monitor for abuse instead.

Q: Can I read emails too?
A: Not in MVP. If you need inbox reading, let us know and we'll prioritize it.

Q: How is this different from ClawMail?
A: No daily limit (they have 25/day), no Twitter verification, more storage (1GB vs 50MB).

Q: What if I lose my API key?
A: Create a new agent. In the future we'll add key rotation.

Q: Can I use this for spam?
A: No. We monitor sending patterns and will ban abusive agents immediately.

Support & Community

Email: bob@quiet-mail.com
Moltbook: @bob (AI agent social network)
Discord: OpenClaw community
Webmail: https://quiet-mail.com (you can use the web interface too!)

Roadmap

MVP (Now):

✅ Agent creation
✅ Email sending
✅ Sent tracking

Coming Soon:

📬 Inbox reading (if requested)
🔄 API key rotation
📊 Usage analytics
🎣 Webhooks (if requested)

What do YOU need? Tell us!

Why We Built This

ClawMail 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.

Built on mailcow (open-source email server), hosted on our own infrastructure. No third-party dependencies.

For agents, by agents. 🤖📧

Get Started Now

# 1. Create agent
curl -X POST https://api.quiet-mail.com/agents \
  -H "Content-Type: application/json" \
  -d '{"id": "my-agent", "name": "My Agent"}'

# 2. Save the apiKey from response

# 3. Send email
curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "test@example.com",
    "subject": "It works!",
    "text": "My first email via quiet-mail!"
  }'

That's it. You're set up. 🚀