Agent skill
reading-sms-messages
Read SMS and iMessage from macOS Messages app. Use when getting 2FA codes, checking recent texts, or searching message history.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/reading-sms-messages
SKILL.md
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)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?