Demerzels-lab ClawMail
Email infrastructure for AI agents at clawmail.xyz.
What it does
ClawMail provides email addresses for LLMs and AI agents with:
- Wallet-based authentication - No passwords, use Ethereum wallet signatures (EIP-191)
- x402 crypto payments - Pay with USDC on Base mainnet
- MCP integration - Direct tool access via Model Context Protocol
- Free tier available - Random email addresses with 1000 message limit
Pricing
| Tier | Cost | Features |
|---|---|---|
| Free | $0 | Random email address, 1000 messages |
| Paid | $1 USDC | Custom email address, unlimited messages |
MCP Tools
This skill provides 5 tools for email management:
check_mailbox_availability
Check if an email address is available for registration.
{ "address": "myagent" }
login
Authenticate using wallet signature. Returns a session token.
{
"address": "myagent@clawmail.xyz",
"walletAddress": "0x...",
"signature": "0x...",
"message": "Sign in to ClawMail..."
}
list_messages
List messages in your inbox.
{
"address": "myagent",
"token": "jwt-token",
"limit": 50,
"unreadOnly": false
}
read_message
Read a specific message by ID. Marks it as read.
{
"address": "myagent",
"messageId": "uuid",
"token": "jwt-token"
}
delete_message
Delete a message from your inbox.
{
"address": "myagent",
"messageId": "uuid",
"token": "jwt-token"
}
Usage
Via npx (recommended)
npx clawmail
Install globally
npm install -g clawmail
clawmail
Configure in Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"clawmail": {
"command": "npx",
"args": ["clawmail"]
}
}
}
API Endpoints
The REST API is available at https://clawmail.xyz:
| Endpoint | Method | Description |
|---|---|---|
/health |
GET | Health check |
/api/mailbox/available/:address |
GET | Check availability |
/api/mailbox |
POST | Create mailbox (x402 protected) |
/api/auth/challenge |
GET | Get login challenge |
/api/auth/login |
POST | Authenticate with wallet |
/api/messages |
GET | List messages |
/api/messages/:id |
GET | Read message |
/api/messages/:id |
DELETE | Delete message |
Authentication Flow
- Get a challenge:
GET /api/auth/challenge - Sign the challenge with your Ethereum wallet (EIP-191 personal_sign)
- Submit signature:
POST /api/auth/login - Use the returned JWT token for subsequent requests
Links
- Website: https://clawmail.xyz
- Source: https://github.com/patrickshuff/clawmail