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.
json
{ "address": "myagent" }
login
Authenticate using wallet signature. Returns a session token.
json
{
"address": "myagent@clawmail.xyz",
"walletAddress": "0x...",
"signature": "0x...",
"message": "Sign in to ClawMail..."
}
list_messages
List messages in your inbox.
json
{
"address": "myagent",
"token": "jwt-token",
"limit": 50,
"unreadOnly": false
}
read_message
Read a specific message by ID. Marks it as read.
json
{
"address": "myagent",
"messageId": "uuid",
"token": "jwt-token"
}
delete_message
Delete a message from your inbox.
json
{
"address": "myagent",
"messageId": "uuid",
"token": "jwt-token"
}
Usage
Via npx (recommended)
bash
npx clawmail
Install globally
bash
npm install -g clawmail clawmail
Configure in Claude Desktop
Add to your claude_desktop_config.json:
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