It took me a little while to track down documentation on using MIME::Tools (which includes MIME::Parser and MIME::Entity) when I needed it for a project.

The module author has copious information at ZeeGee.com

Maybe I was just a bit slow, but it should help.

Cheers

Baz.