skills.rest
eins78
eins78COMMUNITY
Explore all skills by this author →
WebsiteGitHub

apple-mail

Read and query Mail.app emails via AppleScript with structured results.

2|Updated Feb 7, 2026
Search Tags:#automation#macos#read-only#read#osascript#apple-script#apple-mail
One-click install
npx skills add https://github.com/eins78/agent-skills --skill apple-mail-eins78
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-mail
Source: https://github.com/eins78/agent-skills/tree/main/skills/apple-mail
Command: npx skills add https://github.com/eins78/agent-skills --skill apple-mail-eins78

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read email via Mail.app AppleScript. Read-only access for checking, searching, and reading emails without sending or modifying them.

Core Features & Use Cases

  • Read email content from Mail.app using AppleScript (osascript) to fetch message counts, subjects, senders, and bodies.
  • Provides read-only access for quick briefing summaries, targeted queries, and extracting information from inboxes across accounts.
  • Use Case: Ask for the subject of the latest unread email or the body of a specific message for a concise briefing.

Quick Start

Ask your agent to fetch the subject and content of the latest unread email in Mail.app.

Frequently Asked Questions about apple-mail

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

FAQPage Schema
How do I read unread emails from Apple Mail using AppleScript?▼

You can retrieve the latest unread email by asking your agent to query Mail.app. This Skill uses AppleScript to fetch the subject and body of recent unread messages, returning structured results for quick briefings.

Can I automate searching for specific email content in Mail.app without sending messages?▼

Yes, you can automate searching for specific email content in Mail.app without sending messages. This Skill provides read-only access via AppleScript to query and extract message bodies across accounts, ensuring no emails are modified or sent.

Does this approach to reading Apple Mail work on macOS without additional dependencies?▼

Reading Apple Mail this way works on macOS without additional dependencies. It applies to macOS environments where Mail.app is installed and configured, using the built-in osascript bridge to access emails.

Why does my AppleScript automation for Mail.app time out or fail intermittently?▼

AppleScript automation for Mail.app might time out because the AppleScript bridge can be flaky. This Skill handles these intermittent failures by implementing timeouts and retries when fetching message content.

What is the best way to get a quick email briefing from macOS Mail?▼

The best way to get a quick email briefing from macOS Mail is using this Skill to fetch the subject and content of the latest unread messages via AppleScript. It returns structured results for concise summaries.

Related Skills

Explore More Software Engineering Skills→
n0rvynn0rvyn
1

mail

Manage macOS Mail messages and mailboxes via scripted AppleScript actions.

Community
Intermediate
chelleboyerchelleboyer

daily-briefing

Summarize daily sales priorities, meetings, and tasks into a structured briefing.

Community
Intermediate
thirteen37thirteen37
1

daily-briefing

Aggregate calendar events and email inbox status into a daily summary.

Community
Intermediate
GitnappGitnapp

himalaya

Manage IMAP and SMTP mailbox operations from terminal environments via the Himalaya CLI.

Community
Intermediate