imsg

Linux CLI for accessing an iPhone over Bluetooth — read and send messages (SMS, MMS, iMessage), browse contacts, and stream live notifications. Uses MAP (Message Access Profile) and PBAP (Phone Book Access Profile). No Mac required.

Early development — not yet ready for general use.

Features

• List, read, and send messages (SMS, MMS, iMessage)
• Browse and search contacts / phonebook
• Reverse lookup a phone number to a contact name
• Stream live message notification events (watch)

Usage

imsg config set-device <IPHONE_MAC>

imsg list
imsg list --unread
imsg get <handle>
imsg send <number> "hello"

imsg contacts --list
imsg contacts --lookup "+14085551234"

imsg watch

Status

Core commands work. Persistence, local encryption, and full notification support are in progress.

License

MIT