@photon-ai/imessage-kit A type-safe, elegant iMessage SDK for macOS with cross-runtime support A full-featured iMessage SDK for reading, sending, and automating iMessage conversations on macOS. Perfect for building AI agents, automation tools, and chat-first applications. Note ✨ Looking for advanced features like threaded replies, tapbacks, message editing, unsending, live typing indicators? Check out Advanced iMessage Kit and contact us at daniel@photon.codes. Features Quick Start Installation # For Bun (zero dependencies) bun add @photon-ai/imessage-kit # For Node.js (requires better-sqlite3) npm install @photon-ai/imessage-kit better-sqlite3 Basic Usage import { IMessageSDK } from '@photon-ai/imessage-kit' const sdk = new IMessageSDK ( ) // Send a message await sdk . send ( '+1234567890' , 'Hello from iMessage Kit!' ) // Clean up await sdk . close ( ) Configuration interface IMessageConfig { debug ?: boolean // Enable debug logging maxConcurrent ?: number // Max concurrent sends (default: 5) scriptTimeout ?: number // AppleScript timeout in ms databasePath ?: string // Custom database path plugins ?: Plugin [ ] // Plugins watcher ?: { pollInterval ?: number // Polling interval (default: 2000) unreadOnly ?: boolean // Only watch unread (default: false) excludeOwnMessages ?: boolean // Exclude own messages (default: true) } webhook ?: { url : string headers ?: Record < string , string > } } Granting Permission IMessageKit requires Full Disk Access to read your chat history and perform automation tasks. Open System Settings → Privacy & Security → Full Disk Access Click "+" and add your IDE or terminal (e.g., Cursor, VS Code, Terminal, Warp) Messages Send Messages // Send text await sdk . send ( '+1234567890' , 'Hello World!' ) // Send to email await sdk . send ( 'user@example.com' , 'Hello!' ) Send Images // Send local images await sdk . send ( '+1234567890' , { images : [ 'image1.jpg' , 'image2.png' ] } ) // Send network images (auto-download) await sdk . send ( '+...
First seen: 2026-01-11 23:59
Last seen: 2026-01-12 00:59