---
id: apache-airflow-providers-imap
version: "3.12.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# apache-airflow-providers-imap — Provider package apache-airflow-providers-imap for Apache Airflow

License: permissive · Maintenance: active · Downloads: 15.0M/mo

## What it is and what it does

This is an Apache Airflow provider package that adds IMAP (Internet Message Access Protocol) support to Airflow workflows. It allows you to build data pipelines and automation tasks that interact with IMAP mail servers—retrieving messages, checking mailboxes, or triggering workflows based on email events. The package is maintained as part of the Apache Airflow project and integrates seamlessly with Airflow's task and DAG framework.

The package depends on apache-airflow (>=2.11.0) and apache-airflow-providers-common-compat (>=1.12.0), and is distributed as a pure Python wheel with no compiled dependencies. It supports Python 3.10 through 3.14 and is classified as production-stable. Installation is straightforward via pip on top of an existing Airflow instance.

Use it for:

- Monitor an IMAP mailbox and trigger Airflow DAGs when new messages arrive in a specific folder.
- Extract email attachments or metadata from an IMAP server as part of a data ingestion pipeline.
- Build a workflow that reads email content, processes it, and stores results in a database or data warehouse.
- Automate email-based notifications or alerts by connecting Airflow tasks to IMAP mailboxes.
- Synchronize email data from multiple IMAP accounts into a centralized logging or analytics system.

## Worth the install?

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

Integrates IMAP email protocol support into Apache Airflow, enabling workflows to connect to and interact with IMAP mail servers.

Yes, if you are running Apache Airflow and need to integrate IMAP email operations into your workflows. The package is actively maintained, carries no known vulnerabilities, has low install friction, and is production-stable. Install only if you have Airflow >=2.11.0 already running and a genuine need for IMAP connectivity.

## Install

pip install apache-airflow-providers-imap
uv add apache-airflow-providers-imap
poetry add apache-airflow-providers-imap

## Installing apache-airflow-providers-imap

Before you install: Low install friction as a pure Python wheel. Actively maintained with a release 6 days old; requires apache-airflow >=2.11.0 and apache-airflow-providers-common-compat >=1.12.0 as runtime dependencies.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with standard attribution requirements.

Quickstart:

pip install apache-airflow-providers-imap

from airflow.providers.imap.hooks.imap import ImapHook

hook = ImapHook(imap_conn_id='my_imap_connection')
messages = hook.retrieve_mail_messages(mail_box='INBOX')

Requires an existing Apache Airflow >=2.11.0 installation and a configured IMAP connection in Airflow.

Verify before relying:

- Specific IMAP operations and hooks available beyond basic mail retrieval.
- Whether the package includes operators, sensors, or only hooks for IMAP tasks.
- Support for IMAP authentication methods and TLS/SSL configuration details.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 15.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airflow imap email provider, imap integration airflow, email workflow automation, airflow mail server connector, imap provider apache airflow, email task airflow, imap email tasks, airflow-provider, email-integration, workflow-automation

[View on SkillFed](https://skillfed.io/packages/apache-airflow-providers-imap) · [View on PyPI](https://pypi.org/project/apache-airflow-providers-imap/)