photon-hq/imessage-kit
A type-safe, elegant iMessage SDK for macOS with zero dependencies observed · 2026-08-28
Health v2 · maintenance only
71/100
- Activity 86
- Release rhythm 80
- Longevity 22
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 5
- age_days: 319
- days_rel: 135
- days_push: 86
- n_releases_24m: 12
Adoption not part of the score
1447 stars · 129 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A type-safe, zero-dependency TypeScript SDK for reading, sending, and automating iMessage conversations on macOS. It supports sending text, images, and files, querying messages, listing chats, real-time message watching, auto-replying, and a plugin system, making it suitable for building AI agents and chat-first applications.
Use cases
- send imessages from a script on mac
- build an ai agent that replies to imessages
- auto-reply to incoming text messages on macos
- read and query imessage history programmatically
- watch for new imessages in real time
- send images and files via imessage from node
- build a chatbot over imessage and sms
When to choose
- you need to send, read, or automate iMessage on macOS from TypeScript/JavaScript
- you want a zero-dependency SDK with type safety for messaging automation
- you are building AI agents that communicate over iMessage or SMS
When to avoid
- you need cross-platform messaging on Windows or Linux
- you need channels beyond iMessage/SMS like WhatsApp or Telegram (consider the vendor's Spectrum framework instead)
- you need advanced iMessage features like tapbacks, threaded replies, or message editing
Facets
library · maturity active
sdk chatbot agent-framework message-queue workflow-automation messaging-platforms developer-tools apple-ecosystem bun imessage sms messaging-sdk zero-dependency type-safe auto-reply chat-automation ai-agents macos nodejs typescript
4 sources
- readme: https://github.com/photon-hq/imessage-kit · fetched 2026-08-28 · 1b012f1ace77
- homepage: https://photon.codes · fetched 2026-08-29 · b7d22621a09a
- site_page: https://docs.photon.codes · fetched 2026-08-29 · b0a9dd22d5b3
- site_page: https://photon.codes/pricing · fetched 2026-08-29 · 7ad035be5a44
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| photon-hq/imessage-kit | main | 71 |
For agents
markdown · JSON · MCP: product_card(name="photon-hq/imessage-kit")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem