osaurus-mail

Manage Apple Mail emails locally by discovering mailboxes, reading messages, and searching keywords.

5|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/osaurus-ai/osaurus-mail --skill osaurus-mail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: osaurus-mail
Source: https://github.com/osaurus-ai/osaurus-mail/tree/main
Command: npx skills add https://github.com/osaurus-ai/osaurus-mail --skill osaurus-mail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing emails manually can be time-consuming and fragmented across multiple platforms. This Skill streamlines email management by enabling local reading, searching, composing, and organizing in Apple Mail, reducing manual effort and improving productivity.

Core Features & Use Cases

  • Email Discovery and Browsing: Quickly list all mailboxes across accounts and browse message summaries without server queries.
  • Message Search and Retrieval: Search for specific emails by keywords or sender, then fetch full content for review or action.
  • Email Composition and Replies: Draft new emails or reply to existing ones directly within Mail, with options to send immediately or save as drafts for review.
  • Organization and Triage: Move messages between folders, mark as read or flagged, and manage threads, enabling efficient inbox maintenance.

Quick Start

Ask the AI to list all your mailboxes, then request to read unread emails or compose a reply in Mail.

Frequently Asked Questions about osaurus-mail

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

FAQPage Schema
How do I search and read emails locally in Apple Mail without a server connection?

You can search and read emails locally by using AppleScript to discover mailboxes and fetch message contents directly on your device. This allows browsing message summaries and retrieving full text without uploading data externally or relying on continuous server queries.

Can I compose and reply to emails directly through Apple Mail automation?

Yes, you can compose and reply to emails directly within Apple Mail. The automation supports drafting new messages or replying to existing threads, with options to send messages immediately or save them as drafts for later review.

Does this local email management approach work with multiple accounts in Mail?

Local email management works across multiple accounts configured in Apple Mail. You can quickly list all mailboxes across your various accounts and browse message summaries without performing individual server queries for each account.

What is the best way to organize and triage an inbox using AppleScript?

The best way to triage an inbox is by using AppleScript to move messages between folders, mark emails as read or flagged, and manage threads. This enables efficient inbox maintenance and organization directly within the Mail application.

Are there limitations to managing emails locally without uploading data externally?

Managing emails locally means actions are confined to the Apple Mail application on your device. You need Apple Mail installed and configured, as the process relies entirely on local AppleScript execution rather than external server APIs.