imap-mail

Read, search, and update email in IMAP mailboxes using Python standard library.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/HaraldeRoessler/ownify-microclaw --skill imap-mail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imap-mail
Source: https://github.com/HaraldeRoessler/ownify-microclaw/tree/main/skills/built-in/imap-mail
Command: npx skills add https://github.com/HaraldeRoessler/ownify-microclaw --skill imap-mail

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually checking and organizing email by letting you search, read, triage, and move messages directly in any IMAP mailbox.

Core Features & Use Cases

  • Inbox Review: List recent or unread messages with sender, subject, and date so you can quickly spot what matters.
  • Search and Retrieval: Find messages by sender, subject, date, or content across Gmail, iCloud, Fastmail, Proton Bridge, and other IMAP providers.
  • Message Management: Read full messages, mark them read or unread, flag important emails, archive them, move them to folders, or delete them.
  • Use Case: A support operator can ask this Skill to surface all unread customer emails from today, summarize the latest ones, and move resolved threads to an archive folder.

Quick Start

Use the imap-mail skill to connect to my IMAP mailbox, show the latest unread messages, and summarize the ones that look urgent.

Frequently Asked Questions about imap-mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and read unread emails from an IMAP mailbox?

You can search and read unread emails by connecting to an IMAP mailbox using the host, username, and password, then listing recent messages by sender, subject, and date to review unread content directly.

Can I use IMAP to triage and archive emails across different providers like Gmail and iCloud?

Yes, standard IMAP handling works across providers like Gmail, iCloud, Fastmail, and Proton Bridge to triage inbox messages, flag important emails, and archive resolved threads into folders.

What do I need to connect to my IMAP mailbox for inbox triage?

To connect to an IMAP mailbox you need the IMAP host, username, password, and an optional port number to enable searching, reading, flagging, moving, and deleting messages.

How do I move resolved email threads to an archive folder using IMAP?

You can move resolved email threads to an archive folder by applying folder moves to selected messages within an IMAP mailbox after searching and identifying them by sender or subject.

What is the best way to surface urgent customer emails from today in an IMAP inbox?

The best way to surface urgent emails is to search an IMAP inbox for unread messages from today, list them by sender and subject, and summarize the latest ones to spot urgency quickly.

Why does IMAP message management require standard library handling instead of a web API?

IMAP message management uses Python standard library handling to directly interact with mailbox protocols, enabling search, flagging, deletion, and folder moves without relying on provider-specific web APIs.