# Clawmail

> Email service for AI agents with wallet authentication and crypto payments

- Skill: `kernel8901/clawmail` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kernel8901/clawmail`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kernel8901/clawmail/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: kernel8901 (https://skillmd.com/u/kernel8901)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kernel8901/clawmail

---


# 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

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