15 releases (8 breaking)

0.9.1 Aug 28, 2023
0.9.0 Jun 13, 2023
0.8.0 Apr 17, 2023
0.6.0 Jun 27, 2022
0.1.1 Nov 16, 2019

#4 in #imap

Download history 329/week @ 2023-06-08 430/week @ 2023-06-15 347/week @ 2023-06-22 1240/week @ 2023-06-29 266/week @ 2023-07-06 378/week @ 2023-07-13 598/week @ 2023-07-20 430/week @ 2023-07-27 332/week @ 2023-08-03 332/week @ 2023-08-10 167/week @ 2023-08-17 730/week @ 2023-08-24 1637/week @ 2023-08-31 737/week @ 2023-09-07 813/week @ 2023-09-14 544/week @ 2023-09-21

3,841 downloads per month
Used in 2 crates


3.5K SLoC


Async implementation of IMAP

Based on the great rust-imap library.

This crate lets you connect to and interact with servers that implement the IMAP protocol (RFC 3501 and various extensions). After authenticating with the server, IMAP lets you list, fetch, and search for e-mails, as well as monitor mailboxes for changes. It supports at least the latest three stable Rust releases (possibly even older ones; check the CI results).

To connect, use the connect function. This gives you an unauthenticated Client. You can then use Client::login or Client::authenticate to perform username/password or challenge/response authentication respectively. This in turn gives you an authenticated Session, which lets you access the mailboxes at the server.

The documentation within this crate borrows heavily from the various RFCs, but should not be considered a complete reference. If anything is unclear, follow the links to the RFCs embedded in the documentation for the various types and methods and read the raw text there!

See the examples/ directory for examples.

Running the test suite

To run the integration tests, you need to have GreenMail running. The easiest way to do that is with Docker:

$ docker pull greenmail/standalone:1.5.9
$ docker run -t -i -e GREENMAIL_OPTS='-Dgreenmail.setup.test.all -Dgreenmail.hostname= -Dgreenmail.auth.disabled -Dgreenmail.verbose' -p 3025:3025 -p 3110:3110 -p 3143:3143 -p 3465:3465 -p 3993:3993 -p 3995:3995 greenmail/standalone:1.5.9


Licensed under either of


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~228K SLoC