Skip to main content

AIMailbox Logo

aimailbox

An inbox for your agent, no questions asked.

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

Installation

pip install aimailbox

Or with pipx:

pipx install aimailbox

Quick Start

# Create a new inbox
aimailbox create

# List messages
aimailbox list <inbox>

# Read a message
aimailbox read <inbox> 1

# Read the latest message
aimailbox read <inbox> --latest

# Get only the verification code
aimailbox read <inbox> 1 --code-only

# Output as JSON
aimailbox read <inbox> 1 --json

# Delete an inbox
aimailbox delete <inbox>

Features

  • Permissionless: No registration, no KYC, no account required
  • Receive-only: Only receive emails, no sending (prevents spam abuse)
  • AI-friendly: JSON output, automatic verification code extraction
  • Secure: Token-based authentication, only you can read your inbox

Commands

aimailbox create

Create a new inbox. Returns the email address and a secret token.

$ aimailbox create

✓ Inbox created successfully!

  Email:    x7k2m@aimailbox.dev
  Inbox ID: x7k2m
  Token:    abc123...

Token has been saved locally. Keep it safe - it cannot be recovered!

aimailbox list <inbox>

List messages in an inbox.

Options:

  • -l, --limit: Number of messages to show (default: 20)
  • -t, --token: Authentication token (uses stored token if not provided)
  • --json: Output as JSON

aimailbox read <inbox> [index]

Read a specific message.

Options:

  • --latest: Read the latest message
  • -t, --token: Authentication token
  • --json: Output as JSON
  • --code-only: Only output the verification code (useful for scripts)

aimailbox delete <inbox>

Delete an inbox and all its messages.

Options:

  • -f, --force: Skip confirmation
  • -t, --token: Authentication token

Environment Variables

  • AIMAILBOX_API_URL: Override the default API endpoint

Token Storage

Tokens are stored locally in ~/.aimailbox/tokens.json with restricted permissions (600).

License

MIT

Metadata

Release files for aimailbox 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aimailbox 1.0.4
File Size Uploaded Provenance Actions
aimailbox-1.0.4.tar.gz 7.2 kB Without provenance Details for aimailbox-1.0.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aimailbox 1.0.4
File Interpreter ABI Platform Actions
aimailbox-1.0.4-py3-none-any.whl Python 3 none any Details for aimailbox-1.0.4-py3-none-any.whl

Total release size: 15.7 kB

Release files / aimailbox-1.0.4.tar.gz

Download URL aimailbox-1.0.4.tar.gz
Size 7.2 kB
Tags Source
SHA-256 checksum
How to use checksums
efd20c5a8dc613fc9c40195c7428d88fa4a3f6bef171529bbe078ad8bfff7f19
BLAKE2b-256 checksum
How to use checksums
a834d19c2255541c2049852c7fa459fd24c0d0d46c007f1563664891d4c85cad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / aimailbox-1.0.4-py3-none-any.whl

Download URL aimailbox-1.0.4-py3-none-any.whl
Size 8.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f967e2b0f47050ac494efd695f9b84dd31f161c5899d9b881d1b784c7df9053f
BLAKE2b-256 checksum
How to use checksums
430a9042b21a0c2859922beb28aad7981a3aac31fc4ebd499bbd23637a6a66b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for aimailbox 1.0.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page