skills.rest
forwardimpact
forwardimpactOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sync-apple-mail

Sync macOS Mail email threads from SQLite into markdown files.

4|Updated Jan 14, 2026
Search Tags:#automation#markdown#data pipeline#email#macos#sync
One-click install
npx skills add https://github.com/forwardimpact/monorepo --skill sync-apple-mail
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-apple-mail
Source: https://github.com/forwardimpact/monorepo/tree/main/products/basecamp/template/.claude/skills/sync-apple-mail
Command: npx skills add https://github.com/forwardimpact/monorepo --skill sync-apple-mail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of syncing email threads from the macOS Mail app's local database into organized markdown files, making email content accessible for other AI agents and workflows.

Core Features & Use Cases

  • Automated Email Ingestion: Regularly syncs new and updated email threads from your local Mail app.
  • Structured Output: Saves each thread as a distinct markdown file, preserving sender, recipients, date, body, and attachments.
  • Use Case: Automatically sync your email every 5 minutes so that an AI agent can later analyze meeting invitations, extract action items, and add them to your calendar.

Quick Start

Run the sync-apple-mail skill to update your email markdown files.

Frequently Asked Questions about sync-apple-mail

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

FAQPage Schema
How do I sync Apple Mail emails to markdown for AI data ingestion?▼

To sync Apple Mail to markdown, this Skill extracts email threads from the macOS Mail app's local SQLite database and saves them as structured markdown files, preserving sender, recipients, date, and body for automated AI data ingestion.

Do I need Full Disk Access to sync local Apple Mail messages on macOS?▼

Yes, syncing local Apple Mail messages requires macOS with the Mail app configured and Full Disk Access granted to your terminal so the process can read the local SQLite database where email threads are stored.

Can I automate email ingestion on a schedule for AI agent workflows?▼

Yes, you can automate email ingestion on a schedule or on demand. This Skill regularly processes new and updated email threads, enabling an AI agent to analyze meeting invitations and extract action items continuously.

What email data is preserved when syncing Apple Mail threads to markdown files?▼

When syncing Apple Mail threads to markdown files, the process preserves the sender, recipients, date, body, and attachments of each email thread as distinct markdown files for downstream workflows.

What are the limitations of extracting emails directly from the macOS Mail SQLite database?▼

A key limitation is the strict macOS environment dependency; the extraction requires Full Disk Access and a locally configured Mail app, meaning it cannot sync emails from other platforms or web-only email clients.

Related Skills

Explore More Software Engineering Skills→
forwardimpactforwardimpact
4

sync-apple-calendar

Sync macOS Calendar events from SQLite into JSON files.

Official
Intermediate
caffeinelabscaffeinelabs

extension-email-calendar-events

Create, update, and cancel calendar events with iCalendar email invitations.

Official
Intermediate
thecloudtipsthecloudtips
18

Sentiment Analysis

Analyze Gmail and Google Calendar signals to compute a client sentiment score.

Community
Advanced
mupengi-botmupengi-bot
11

Mail

Send and manage emails via Apple Mail SQLite and himalaya CLI.

Community
Advanced