mail-parser
A tool that parses emails by enhancing the Python standard library, extracting all details into a comprehensive object.
Decision gist · record as of 2026-08-14
Yes. mail-parser is actively maintained, has no runtime dependencies, supports current Python versions, carries a permissive Apache-2.0 license, and has no known vulnerabilities. It is purpose-built for email security and forensics with proven production use. Install it if you need reliable, RFC-compliant email parsing with security-focused defect detection; the optional Outlook support makes it versatile for mixed email ecosystems.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Optional: install mail-parser[outlook] for native .msg file support via extract-msg.
- Low friction installation with no runtime dependencies.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows free use, modification, and distribution with minimal restrictions, suitable for both open-source and commercial projects.
last release 2026-08-12 (2 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,238,692 downloads/mo, #2,687 on PyPI
Alternatives
Verify before relying
pip install mail-parser
from mail_parser import parse_from_file
mail = parse_from_file('message.eml')
print(mail.from_, mail.to, mail.subject)- Exact performance characteristics (parsing speed, memory usage) for large-scale deployments or very large attachments.
- Completeness of RFC compliance coverage—which specific RFCs are fully supported versus partially.
- Availability and quality of API documentation beyond the description excerpt.
What it is and what it does
mail-parser is a production-grade email parsing library that transforms raw email messages into richly structured Python objects. It goes beyond Python's standard email module by extracting every component—headers, plain-text and HTML bodies, attachments with full metadata, routing chains from Received headers, and RFC defects—into a unified object model. Every parsed element is accessible in three formats: native Python objects for direct use, raw strings preserving original formatting, and JSON for integration with external systems.
The library is built for security and forensics use cases, with particular strength in detecting malformed structures, RFC violations, and hidden content that could indicate malicious intent. It natively handles both standard .eml files and Microsoft Outlook .msg files (via the optional extract-msg backend). With no runtime dependencies and support for Python 3.9 through 3.14, it is designed to integrate into production email security pipelines, threat analysis platforms, and compliance workflows.
Use it for
- Security analysis: detect malformed email structures, RFC violations, and anomalies that may indicate phishing or malware.
- Email forensics: extract complete routing chains, timestamps, and metadata for incident investigation and evidence preservation.
- Outlook integration: parse .msg files from Microsoft Outlook alongside standard .eml messages in unified workflows.
- Compliance auditing: extract and validate email headers and routing for regulatory requirements and audit trails.
- Threat intelligence: feed parsed email components into automated detection systems for spam, phishing, and malware analysis.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
mail-parser is actively maintained, has no runtime dependencies, supports current Python versions, carries a permissive Apache-2.0 license, and has no known vulnerabilities. It is purpose-built for email security and forensics with proven production use. Install it if you need reliable, RFC-compliant email parsing with security-focused defect detection; the optional Outlook support makes it versatile for mixed email ecosystems.
Install
mail-parser on PyPI
Before you install
Low friction installation with no runtime dependencies. Actively maintained with a release 2 days ago and support for current Python versions (3.9–3.14). Optional Outlook support via the `[outlook]` extra.
Requires Python 3.9 or later. Optional: install mail-parser[outlook] for native .msg file support via extract-msg.
License in practice
Apache-2.0 permissive license allows free use, modification, and distribution with minimal restrictions, suitable for both open-source and commercial projects.
Quickstart
pip install mail-parser
from mail_parser import parse_from_file
mail = parse_from_file('message.eml')
print(mail.from_, mail.to, mail.subject)Verify before relying
- Exact performance characteristics (parsing speed, memory usage) for large-scale deployments or very large attachments.
- Completeness of RFC compliance coverage—which specific RFCs are fully supported versus partially.
- Availability and quality of API documentation beyond the description excerpt.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <3.15,>=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 2 days since the last release |
| First released | |
| Downloads | 3,238,692 / month, #2,687 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Natural Language :: EnglishOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: UnixProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9 |
Evidence: mail_parser-4.6.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “RFC-compliant email parser”
- mail-parserParses raw email messages into structured Python objects with RFC…
- pmd-net-protoParses, assembles, and validates network protocol packets (Ethernet…
- emvalValidates email addresses according to RFC 5322 and RFC 6531, with…
Give your agent the search over MCP, or paste the wish link into any chat.
More Security packages
Provides Python bindings to the FreeDesktop.org Secret Service API for securely storing and retrieving passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.
MSAL for Python handles OAuth2 and OpenID Connect authentication with Microsoft identity services, managing token acquisition, caching, and refresh for applications integrating with Microsoft Entra ID, Microsoft Accounts, and Azure AD B2C.
joserfc implements JOSE standards (JWS, JWE, JWK, JWT, and related RFCs) for signing, encrypting, and managing JSON-based cryptographic tokens in Python.
Authlib provides a complete implementation of OAuth 1.0, OAuth 2.0, and OpenID Connect 1.0 for building both authentication clients and servers, with built-in support for JWS, JWK, JWA, and JWT standards.
Provides low-level CFFI bindings to the official Argon2 password hashing algorithm for use by libraries and applications that need direct access to Argon2 without higher-level abstractions.
ADAL for Python authenticates applications with Azure Active Directory to obtain tokens for accessing Azure AD-protected resources.
Install only if maintaining existing code that already depends on it, and plan a migration.
See also eml-parser · extract-msg · mailbits · pyrfc6266 · msg-parser · python-oxmsg · tnefparse · mailsuite · mail-parser-reply · RTFDE