Mail Assistant

Search and manage emails on IMAP servers without Mail.app.

29|1|Updated Feb 2, 2026

Search Tags:#email #email automation #email management #email search #imap

Ready to run

npx skills add https://github.com/spamsch/son-of-simon --skill mail-assistant

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Mail Assistant
Source: https://github.com/spamsch/son-of-simon/tree/main/skills/mail_assistant
Command: npx skills add https://github.com/spamsch/son-of-simon --skill mail-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows you to find and act on emails over IMAP without needing to open Mail.app, providing a hands-free way to manage your emails.

Core Features & Use Cases

IMAP Account Management: Discover which email accounts are logged in and manage them.
Email Search: Search for emails using various filters like sender, subject, and date.
Email Actions: Read, download attachments, draft new emails, mark as read/unread, archive, and move to trash.
Use Case: If you need to find and act on emails from a specific account while Mail.app is closed, this Skill can help you do so efficiently.

Quick Start

Use the mail_assistant skill to find unread emails from the last week in your operayo account.

Frequently Asked Questions about Mail Assistant

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

FAQPage Schema

How do I manage emails over IMAP without opening a dedicated email client?▼

You can manage emails over IMAP without a dedicated client by using scripts to search, read, move, and archive messages directly from the server. This hands-free approach bypasses standard graphical mail application interfaces.

Can I search for emails by sender and date without using Mail.app?▼

Yes, you can search emails without Mail.app by applying IMAP filters for sender, subject, and date. This allows you to find specific messages and perform actions like archiving or marking as read directly on the server.

What email actions can I perform on an IMAP server without a graphical interface?▼

You can perform multiple email actions on an IMAP server including reading, downloading attachments, drafting, moving to trash, and archiving. This requires IMAP access and account authentication to execute these management operations.

Do I need to configure IMAP authentication to search and manage my emails?▼

Yes, IMAP access and authentication are required to search and manage your emails. You must provide valid login credentials for your email account so the scripts can securely connect to the server and perform actions.

How do I find unread emails from a specific account over IMAP?▼

To find unread emails from a specific account over IMAP, use search filters to locate messages matching your criteria, such as unread status and sender. This hands-free method retrieves emails without opening a mail application.

Are there limitations to managing emails directly on an IMAP server without a client?▼

Managing emails directly on an IMAP server requires proper authentication and network access. Without a graphical client interface, you rely on script commands for actions like reading and moving, which suits automated workflows over manual browsing.