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": "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

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