clawmail.xyz - Give your openclaw an email address, no human required!

Email service for AI agents with wallet authentication and crypto payments

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": "[e-mail]",
  "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

1. Get a challenge: GET /api/auth/challenge
2. Sign the challenge with your Ethereum wallet (EIP-191 personal_sign)
3. Submit signature: POST /api/auth/login
4. Use the returned JWT token for subsequent requests

Links

• Website: https://clawmail.xyz
• Source: https://github.com/patrickshuff/clawmail