Agent skill

macos-tools

macOS native integrations: screen capture, calendar, reminders, contacts, email (Mail.app), Spotlight search. Use when the user asks about their screen, schedule, to-do list, contacts, or wants to send email on macOS.

View SKILL.md on GitHub Repository
Stars 114
Forks 23

Install this agent skill to your Project

npx add-skill https://github.com/sonichi/sutando/tree/main/skills/macos-tools

SKILL.md

macOS Tools

Native macOS integrations via AppleScript. No API keys needed — works on any Mac.

When to Use

  • Screen: "What's on my screen?", "help me with this", "describe what I'm looking at"
  • Calendar: "What's on my schedule?", "do I have meetings today?"
  • Reminders: "Add a reminder", "what's on my todo list?", "mark X as done"
  • Contacts: "What's Bob's email?", "find contact for..."
  • Email: "Send an email to...", "draft a message to..."
  • File search: "Find my resume", "where's that PDF?"

Tools

Screen Capture

bash
bash "$SKILL_DIR/scripts/screen-capture.sh"

Returns path to PNG screenshot. Use the Read tool on the path to view it.

Calendar

Prefer the google-calendar skill if installed. Fallback to macOS Calendar:

bash
python3 "$SKILL_DIR/scripts/calendar-reader.py" 7          # next 7 days, JSON
python3 "$SKILL_DIR/scripts/calendar-reader.py" 1 text     # today, plain text

Reminders

bash
python3 "$SKILL_DIR/scripts/reminders.py" list              # all incomplete
python3 "$SKILL_DIR/scripts/reminders.py" add "Call Bob"     # add reminder
python3 "$SKILL_DIR/scripts/reminders.py" add "Fix bug" "2026-03-17"  # with due date
python3 "$SKILL_DIR/scripts/reminders.py" complete "Call Bob" # mark done

Contacts

bash
python3 "$SKILL_DIR/scripts/contacts.py" search "Bob"       # find by name

Returns name, emails, phones. Use before sending email to resolve names to addresses.

Email (Apple Mail)

bash
python3 "$SKILL_DIR/scripts/email-sender.py" "to@example.com" "Subject" "Body"
python3 "$SKILL_DIR/scripts/email-sender.py" "to@example.com" "Subject" "Body" --draft

Sends via Mail.app. Use --draft to create without sending. Always confirm with user before sending.

Spotlight File Search

bash
mdfind "quarterly report"                    # search by content or filename
mdfind -name "resume.pdf"                    # search by filename only

Requirements

  • macOS (uses AppleScript)
  • Calendar, Reminders, Contacts, Mail apps (built into macOS)
  • Grant Accessibility permissions if prompted

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

sonichi/sutando

x-twitter

Post tweets, search, read mentions, and check engagement on X (Twitter) via API v2.

114 23
Explore
sonichi/sutando

schedule-crons

114 23
Explore
sonichi/sutando

claude-codex

Use the local Codex CLI from Claude Code with the user's existing Codex login or API key. Use for Codex reviews, second-opinion analysis, implementation delegation, or non-interactive Codex runs in the current workspace.

114 23
Explore
sonichi/sutando

phone-conversation

Make conversational phone calls and join Zoom meetings via Twilio + Gemini. Multi-turn AI conversations on the phone on behalf of the user.

114 23
Explore
sonichi/sutando

screen-record

114 23
Explore
sonichi/sutando

quota-tracker

Track Claude Code quota usage via Anthropic API rate limit headers. Shows 5h and 7d utilization, reset times, and quota status. Works with both subscription and API key auth.

114 23
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results