Project overview
imessage-spam-cleanup scans the Messages chat database read-only, classifies conversations as spam, normal, or unknown, and creates a human-readable report before anything is removed. After explicit approval, it uses Messages.app UI automation, protects whitelisted contacts, and relies on the app's Recently Deleted area for 30-day recovery. The skill requires macOS 14 or later, a signed-in Messages.app, Full Disk Access, Accessibility permission, and Python 3.9+.
Repository facts
- Primary language
- Python
- License
- MIT
- Repository updated
- Apr 30, 2026
- Default branch
- main
Resource types
General skill
Use cases
Communication and collaborationPersonal and daily life
Platforms
Claude Code, Codex, and more
Runtime
Command lineLocal
Capabilities
Security guardrailWorkflow automation
Audience
General users