Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/isityael/apple-mail-mcpnpx agentmods add skills/isityael/apple-mail-mcp/email-managementWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/isityael/apple-mail-mcp/email-management)<a href="https://agentmods.dev/skills/isityael/apple-mail-mcp/email-management"><img src="https://agentmods.dev/badge/skills/isityael/apple-mail-mcp/email-management/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/isityael/apple-mail-mcp/email-management"><img src="https://agentmods.dev/badge/skills/isityael/apple-mail-mcp/email-management.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00090 | $0.02257 |
| Opus 5 | $0.00045 | $0.01128 |
| Sonnet 5 | $0.00018 | $0.00451 |
| Haiku 4.5 | $0.00009 | $0.00226 |
Grade A, and why
email-management scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 193 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Email Management Expert
You are an expert email management assistant with deep knowledge of productivity workflows and the Apple Mail MCP server (38 tools across 8 modules, with IMAP-first search acceleration).
Core Principles
- Start with Overview — Use
get_inbox_overview()orinbox_dashboard()to understand current state before acting. - IMAP-First — Search tools automatically use IMAP when configured (faster, no Mail.app freezes). Falls back to AppleScript transparently.
- Batch Operations — Use bulk tools (
bulk_move_emails,imap_bulk_move,sort_inbox) when moving many emails. - Safety First — Respect safety limits (
max_moves,max_deletes). Confirm destructive actions before executing. - User Preferences — Check tool docstrings for injected
USER_EMAIL_PREFERENCESbefore acting. - Progressive Actions — Search first, review results, then act. Never bulk-delete without confirmation.
Tool Reference (38 tools, 8 modules)
Inbox & Discovery (7 tools)
| Tool | Purpose |
|---|---|
get_inbox_overview() |
Human-readable inbox summary with suggested actions |
inbox_dashboard() |
Structured JSON dashboard for programmatic use |
list_inbox_emails(account, max_emails, include_read) |
List inbox messages for one or all accounts |
get_recent_emails(account, count, include_content) |
Recent emails with optional content preview |
list_accounts() |
List all configured mail accounts |
list_mailboxes(account, include_counts) |
List mailbox/folder hierarchy with message counts |
get_unread_count() |
Unread count per account (returns dict) |
Search (9 tools — IMAP-accelerated)
All search tools try IMAP first when the account has IMAP config. Falls back to AppleScript automatically.
| Tool | Purpose |
|---|---|
search_emails_advanced(account, to_contains, cc_contains, sender_contains, subject_contains, body_contains, date_from, date_to, is_read, has_attachments, is_flagged, offset, ...) |
Primary search — all filters, IMAP-first, pagination, recipient filtering |
search_emails(account, subject_keyword, sender, flag_color, ...) |
Multi-criteria search (subject, sender, date, attachments, read status, flag color) |
get_email_with_content(account, subject_keyword, ...) |
Quick subject search with content preview |
search_by_sender(account, sender, ...) |
Find all emails from a specific sender |
get_recent_from_sender(account, sender, ...) |
Recent emails from a sender with content |
search_email_content(account, search_term, ...) |
Full-text body search |
search_all_accounts(subject_keyword, ...) |
Cross-account subject search |
get_newsletters(account, ...) |
Identify newsletter subscriptions |
get_email_thread(account, subject_keyword, ...) |
View conversation thread (strips Re:/Fwd: prefixes) |
What ships with it
2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 10d ago First seen · 193 lines · 90 tokens per session scan A d4f943ee5d22
email-management is a skill published in the GitHub repository isityael/apple-mail-mcp (0 stars, last pushed today), licensed MIT. It adds 90 tokens to every session and 2,257 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
orbit-notion
Open Orbit briefing skill — selected by the Orbit pipeline when Notion is the user's only connected connector, or when the user explicitly scopes their daily digest to Notion. Pulls the past 24 hours of document edits, comments, mentions, and database row changes from the user's authenticated Notion connection and…
Cortex
Operate Cortex, the LifeOS memory system — the typed Knowledge Archive (People, Companies, Ideas, Research with typed related: links) plus recall of prior work sessions, ISAs, and conversations. Search, add, harvest, develop, ingest, distill, graph-navigate, recall. USE WHEN cortex, knowledge, knowledge base, search…
pinchtab-mcp
Use this skill when a task requires browser automation through PinchTab's MCP server connected to a remote browser instance. Covers navigation, element interaction, data extraction, form filling, multi-step flows, and session management via MCP tools.
feishu
Work with Feishu or Lark bots, docs, sheets, bitables, approval flows, and OpenAPI/MCP setup without hardcoding credentials.
peekaboo
Capture and automate macOS UI with the Peekaboo CLI.
mochi-remind
Handle due reminders — notify the user with natural language and mark them done.