---
id: agentmail
version: "0.5.9"
license: unclear
license_treatment: unclear
maintenance: active
---

# agentmail

License: unclear · Maintenance: active · Downloads: 4.3M/mo

## What it is and what it does

Agentmail is a Python SDK that wraps the Agentmail API, offering both synchronous and asynchronous clients for making API calls. It handles HTTP communication through httpx, data validation via pydantic, and includes built-in retry logic with exponential backoff for transient failures (408, 429, 5xx responses). The library also supports real-time websocket connections for low-latency, bidirectional communication, allowing you to either iterate over incoming messages or attach event handlers.

The package is designed for developers integrating Agentmail services into Python applications. It abstracts away HTTP details, provides typed request/response handling, and offers both blocking and non-blocking execution paths. Configuration options include custom timeouts, retry limits, proxy support via custom httpx clients, and raw response access for advanced use cases.

Use it for:

- Build a Python application that creates and manages email inboxes via the Agentmail API.
- Implement real-time message handling using websocket connections for low-latency event processing.
- Integrate Agentmail into an async web service or background task runner without blocking I/O.
- Access raw HTTP response headers and status codes for debugging or custom error handling.
- Deploy behind a proxy or with custom network transport by passing a configured httpx client.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Agentmail provides a Python client library for accessing the Agentmail API, supporting both synchronous and asynchronous operations, including real-time websocket connections.

Yes, if you are building a Python application that needs to integrate with Agentmail services. The package has low install friction, active maintenance, no known vulnerabilities, and supports modern Python versions (3.8–3.15). The main caveat is that the license is unclear in the metadata—verify the actual license before use in proprietary contexts. The SDK is generated programmatically, so direct contributions are not accepted.

## Install

pip install agentmail
uv add agentmail
poetry add agentmail

## Installing agentmail

Before you install: Low install friction with a pure-wheel distribution and only five runtime dependencies (httpx, pydantic, pydantic-core, typing_extensions, websockets). Actively maintained with a release 11 days old and recent commit activity.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or restricted contexts.

Quickstart:

pip install agentmail

from agentmail import AgentMail

client = AgentMail(api_key="your-api-key")
client.inboxes.create()

Requires a valid Agentmail API key to authenticate requests.

Verify before relying:

- What is the actual license under which agentmail is distributed?
- What specific Agentmail API endpoints and operations are supported beyond inboxes?
- Are there rate limits or quotas enforced by the Agentmail service itself?

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

agentmail api client, python email api sdk, async http client library, websocket real-time communication, api wrapper python, rest client sdk, async email service, api-client, async-support, websockets

[View on SkillFed](https://skillfed.io/packages/agentmail) · [View on PyPI](https://pypi.org/project/agentmail/)