Was torn between using this and the PEP Email::* modules usually recommended for mail projects, but then I read the hilarious Moonpig slides (especially slides 24 and 26) and decided to go with this set of modules.
The package itself is very capable and does pretty much anything you throw at it. That said, the documentation leaves a lot to be desired. Too much emphasis is placed on the internal details of how it works as opposed to simply giving a "black box" view of how to accomplish your goal. For example, a clear way of creating a POP3 mailbox accessor isn't provided until several pages down in the documentation on the POP3 module. It should be, IMO, at the very top of it.