mxRaven Python SDK

The official Python SDK for the mxRaven mail-facing runtime surfaces.

It covers three integration points:

• SMTP submission (mxraven) — submit mail through the mxRaven submission service.
• Webhooks (mxraven.webhook) — verify and decode DELIVER_WEBHOOK and NOTIFY_WEBHOOK deliveries.
• MIME parsing (mxraven.mime) — turn the raw message behind an inbound-email payload into headers, bodies, and decoded attachments.
• Feedback (mxraven.feedback) — train the spam filter and perform RFC 8058 one-click unsubscribes.
• Notifications (mxraven.notify) — consume a listener's accepted-message and delivery-attempt events over NATS JetStream.

Control-plane administration is out of scope and lives in the separate control-plane SDK.

Early development

The public API is not yet stable. Pin the version you depend on.

Install

uv add mxraven
# or
pip install mxraven

See SMTP submission, Webhooks, Feedback, and Notifications for usage, or the API reference for the complete surface.