imessage-mac
Installation
SKILL.md
iMessage on macOS — Programmatic Interaction Guide
Complete technical reference for reading, querying, and sending iMessages on macOS via AppleScript, SQLite, Python, and third-party tools.
Quick Reference
| Topic | Reference File |
|---|---|
| chat.db schema, tables, columns, SQL queries | database-schema.md |
| AppleScript / osascript sending examples | applescript-sending.md |
| Python sqlite3 reading examples | python-reading.md |
| Permissions (TCC, FDA, Automation) | permissions.md |
| Third-party tools and open-source projects | third-party-tools.md |
| Limitations, gotchas, macOS version issues | limitations.md |
Core Architecture
iMessage on macOS stores all data locally in a SQLite database at: