" "<body>" --folder "<folder>"` - `apple-flow tools notes_append "<title-or-id>" "<text>" --folder "<folder>"` - Calendar: - `apple-flow tools calendar_list_calendars` - `apple-flow tools calendar_list_events --cal "<calendar>" --days 7` - `apple-flow tools calendar_search <query> --cal "<calendar>"` - `apple-flow tools calendar_create "<title>" "<start>" --end "<end>" --cal "<calendar>"` ## Shared Safety Rules - Keep mutating intent behind approval flows (`task:` and `project:`) in relay workflows. - Prefer read/list/search before create/update operations. - Use explicit list/folder/calendar/account names instead of assuming defaults in critical runs. - Use absolute paths for file-backed tools. ## Quick Gateway Triage 1. Confirm macOS app access: - first run may require Automation permissions. 2. Confirm resource names: - reminders list, notes folder, calendar names must exactly match. 3. Run a list command first: - if list fails/empty unexpectedly, do not continue with mutations. 4. Re-run with explicit selectors: - `--list`, `--folder`, `--cal`, `--account`, `--mailbox`. ## Escalate To Specialized Skill - For multi-step mailbox triage, message-id handling, or label workflows, use `apple-flow-mail`. ## Done Criteria - Correct gateway chosen for the request. - Read command confirms expected target objects. - Mutating step uses explicit resource selectors and succeeds. --- > Source: [dkyazzentwatwa/apple-flow](https://github.com/dkyazzentwatwa/apple-flow) — distributed by [TomeVault](https://tomevault.io). <!-- tomevault:4.0:skill

# Apple Flow Gateways > Core routing and troubleshooting skill for Apple Flow gateways (Mail, Reminders, Notes, Calendar). Use when deciding which `apple-flow tools` command to run, applying shared safety rules, or debugging gateway permissions/resource-name mismatches. Use when this capability is needed. - Skill: `tomevault-io/apple-flow-gateways` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/apple-flow-gateways` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/apple-flow-gateways/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/apple-flow-gateways --- # Apple Flow Gateways Use this as the first-stop skill for cross-gateway work. It helps choose the right command path quickly and safely. ## Use This Skill For - Picking the right gateway tool for a user request. - Running quick health checks for Mail, Reminders, Notes, or Calendar. - Troubleshooting empty results, app permission prompts, or wrong resource names. - Applying shared Apple Flow safety defaults before mutating workflows. ## Command Matrix - Mail: - `apple-flow tools mail_list_unread` - `apple-flow tools mail_search ` - `apple-flow tools mail_get_content ` - `apple-flow tools mail_send ` - `apple-flow tools mail_move_to_label --label --message-id ` - Reminders: - `apple-flow tools reminders_list_lists` - `apple-flow tools reminders_list --list ""` - `apple-flow tools reminders_search --list ""` - `apple-flow tools reminders_create "" --list "" --due YYYY-MM-DD` - `apple-flow tools reminders_complete --list ""` - Notes: - `apple-flow tools notes_list_folders` - `apple-flow tools notes_list --folder ""` - `apple-flow tools notes_search --folder ""` - `apple-flow tools notes_get_content "" --folder ""` - `apple-flow tools notes_create "" "<body>" --folder "<folder>"` - `apple-flow tools notes_append "<title-or-id>" "<text>" --folder "<folder>"` - Calendar: - `apple-flow tools calendar_list_calendars` - `apple-flow tools calendar_list_events --cal "<calendar>" --days 7` - `apple-flow tools calendar_search <query> --cal "<calendar>"` - `apple-flow tools calendar_create "<title>" "<start>" --end "<end>" --cal "<calendar>"` ## Shared Safety Rules - Keep mutating intent behind approval flows (`task:` and `project:`) in relay workflows. - Prefer read/list/search before create/update operations. - Use explicit list/folder/calendar/account names instead of assuming defaults in critical runs. - Use absolute paths for file-backed tools. ## Quick Gateway Triage 1. Confirm macOS app access: - first run may require Automation permissions. 2. Confirm resource names: - reminders list, notes folder, calendar names must exactly match. 3. Run a list command first: - if list fails/empty unexpectedly, do not continue with mutations. 4. Re-run with explicit selectors: - `--list`, `--folder`, `--cal`, `--account`, `--mailbox`. ## Escalate To Specialized Skill - For multi-step mailbox triage, message-id handling, or label workflows, use `apple-flow-mail`. ## Done Criteria - Correct gateway chosen for the request. - Read command confirms expected target objects. - Mutating step uses explicit resource selectors and succeeds. --- > Source: [dkyazzentwatwa/apple-flow](https://github.com/dkyazzentwatwa/apple-flow) — distributed by [TomeVault](https://tomevault.io).