apple-mail

Read and interact with Apple Mail accounts, mailboxes, and messages via AppleScript.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/jieni777/opencode-config-backup --skill apple-mail-jieni777
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-mail
Source: https://github.com/jieni777/opencode-config-backup/tree/main/skills/apple-mail-moltbot-skill
Command: npx skills add https://github.com/jieni777/opencode-config-backup --skill apple-mail-jieni777

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Read and interact with Apple Mail on macOS to enable automated access to accounts, mailboxes, and messages for AI-driven workflows.

Core Features & Use Cases

  • List accounts
  • List mailboxes for an account
  • Get messages from a mailbox
  • Read full message content

Quick Start

Ask to list accounts, list mailboxes for an account, retrieve messages from a mailbox, or read a message by its ID.

Frequently Asked Questions about apple-mail

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

FAQPage Schema
How do I read Apple Mail messages using an AI workflow?

You can automate reading Apple Mail messages by listing accounts, selecting a mailbox, and fetching full message content through AppleScript automation on macOS.

Can I list all mailboxes for a specific account in Apple Mail?

Yes, you can list mailboxes for a specific account in Apple Mail by requesting the mailbox list for a chosen account through the AppleScript interface.

Does this Apple Mail automation work on Windows or Linux?

No, this Apple Mail automation requires macOS because it uses osascript and AppleScript to interact with the native Apple Mail application, which must be running and configured.

How do I get full message content from a mailbox using osascript?

You get full message content by first listing mailboxes for an account, fetching messages from the target mailbox, and then reading a specific message by its ID through osascript.

What are the limitations of automating Apple Mail with AppleScript?

Limitations of automating Apple Mail with AppleScript include requiring the Apple Mail app to be actively running, having at least one configured account, and being restricted to macOS environments only.