reading-sms-messages - SKILL.md Agent Skill

name: reading-sms-messages description: "Use when reading SMS or iMessage from the macOS Messages app. Triggered by requests to get 2FA codes, check recent texts, or search message history." allowed-tools: Read, Bash user-invocable: false

SMS Reader

Location: ~/Library/Messages/chat.db (macOS Messages database)

CLI: python -m tools.sms_reader.cli

Commands

# Get 2FA code from last 5 minutes
python -m tools.sms_reader.cli 2fa
python -m tools.sms_reader.cli 2fa --minutes 10 --sender "+1555"
python -m tools.sms_reader.cli 2fa --detailed  # full message info as JSON

# Recent messages
python -m tools.sms_reader.cli recent
python -m tools.sms_reader.cli recent --limit 10 --sender "+1555" --since-minutes 30

# Search messages by content
python -m tools.sms_reader.cli search "verification"
python -m tools.sms_reader.cli search "code" --limit 5

# List senders
python -m tools.sms_reader.cli senders
python -m tools.sms_reader.cli senders --limit 10 --since-days 7

Requirements

macOS with Messages app
Full Disk Access for Python (System Settings > Privacy & Security > Full Disk Access)