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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.