AIMailbox

An inbox for your agent, no questions asked.

Permissionless email for AI agents. No signup, no KYC, no wait.

Quick Start

npm install -g aimailbox

pip install aimailbox

# Create inbox
aimailbox create
→ Email: x7k2m@aimailbox.dev

# Check messages
aimailbox list x7k2m

# Get verification code
aimailbox read x7k2m --latest --code-only
→ 847291

Commands

AI Agent Integration

Bash

EMAIL=$(aimailbox create --json | jq -r '.email')
# Use $EMAIL for registration...

# Poll for verification code
CODE=$(aimailbox read $EMAIL --latest --code-only)
echo "Code: $CODE"

Python

import subprocess, json

# Create inbox
result = subprocess.run(["aimailbox", "create", "--json"], capture_output=True, text=True)
inbox = json.loads(result.stdout)
print(f"Email: {inbox['email']}")

# Get verification code
result = subprocess.run(
    ["aimailbox", "read", inbox['id'], "--latest", "--code-only"],
    capture_output=True, text=True
)
print(f"Code: {result.stdout.strip()}")

Node.js

const { execSync } = require('child_process');

// Create inbox
const inbox = JSON.parse(execSync('aimailbox create --json', { encoding: 'utf-8' }));
console.log(`Email: ${inbox.email}`);

// Get verification code
const code = execSync(`aimailbox read ${inbox.id} --latest --code-only`, { encoding: 'utf-8' }).trim();
console.log(`Code: ${code}`);

How It Works

1. Create inbox → Get random email address + auth token

2. Receive email → Emails to *@aimailbox.dev are stored

3. Read messages → Verification codes are auto-extracted

4. Secure access → Only token holder can read messages

Security

Links

GitHub · npm · PyPI