Skip to main content

ClawAIMail Python SDK

Email infrastructure for AI agents. Give your AI a real email address.

Install

pip install clawaimail

Quick Start

from clawaimail import ClawAIMail

mail = ClawAIMail(api_key="pb_your_api_key")

# Create an inbox
inbox = mail.create_inbox(username="mybot")
print(inbox["address"])  # mybot@clawaimail.com

# Send an email
mail.send_message(
    inbox_id=inbox["id"],
    to="user@example.com",
    subject="Hello from AI",
    text="This email was sent by an AI agent!"
)

# Read messages
messages = mail.list_messages(inbox["id"])
for msg in messages:
    print(f"{msg['from_address']}: {msg['subject']}")

# Search
results = mail.search_messages(inbox["id"], "invoice")

All Methods

Method Description
me() Get account info
create_inbox(username) Create email inbox
list_inboxes() List all inboxes
delete_inbox(id) Delete inbox
list_messages(inbox_id) List messages
get_message(inbox_id, msg_id) Read a message
send_message(...) Send an email
search_messages(inbox_id, q) Search emails
list_threads(inbox_id) List threads
create_label(name, color) Create label
create_webhook(url, events) Create webhook
add_domain(domain) Add custom domain

Metadata

Release files for clawaimail 0.1.0

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

Source distribution (sdist)

Source distribution for clawaimail 0.1.0
File Size Uploaded Provenance Actions
clawaimail-0.1.0.tar.gz 3.3 kB Without provenance Details for clawaimail-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 6.6 kB

Release files / clawaimail-0.1.0.tar.gz

Download URL clawaimail-0.1.0.tar.gz
Size 3.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f92c1723ec4f5071ef2f23128afce8a68d18546107d8994749fc7fd7b7d2696f
BLAKE2b-256 checksum
How to use checksums
221a4b50e158c7d07072e82db7ceb647771becf76d8c57733bdea4082067c46d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / clawaimail-0.1.0-py3-none-any.whl

Download URL clawaimail-0.1.0-py3-none-any.whl
Size 3.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0f6b0a2090911f1f9ee299a350c001b5d258eb64bb5eab950b3e8d59d9c69eff
BLAKE2b-256 checksum
How to use checksums
b2ef5e95ce408c88757bab827cbee70fc7daea197893a883d160dc5162af3e91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for clawaimail 0.1.0

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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