--- name: clawmail description: Email service for AI agents with wallet authentication and crypto payments metadata: openclaw: emoji: "📧" bins: - node - npx os: - darwin - linux - win32 install: npm: clawmail homepage: https://clawmail.xyz capabilities: - email - mcp - wallet-auth - x402 ---

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": "[email protected]",
  "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