imessage-sdk

Overview

imessage-sdk is an open-source (MIT) TypeScript project at github.com/jmisilo/imessage-sdk, published on npm. It does not send messages by itself: you connect it to an account with a hosted iMessage provider, and it gives your code one typed client for that provider. The built-in providers are Blooio, Comms by Osis, Photon and Sendblue, and you can add your own with defineProvider(). The latest releases are from July 27, 2026.

Key features

• One normalized client for text, attachments, replies, reactions, typing, read state and message lookup, where the provider supports them
• Typed capability flags; unsupported operations throw an error instead of failing silently
• Signed webhook verification and normalized inbound events
• imessage-cli with JSON input and output, connections saved in the OS keychain, dry runs and an experimental local webhook server
• @imessage-sdk/chat-adapter for Vercel's Chat SDK
• A public contract for custom providers

Pricing

Free, MIT-licensed software. Messaging costs depend on the provider account you connect.

How it compares to Linq

Linq is a messaging provider with its own lines, API and SDKs. imessage-sdk is a client library, and it has no Linq provider. Version 0.1 handles direct conversations only: groups, edits, polls, effects, FaceTime and location sharing are postponed or out of scope, while Linq's API supports groups, edits, polls, effects and location sharing. Both offer an adapter for Vercel's Chat SDK.

Best for

TypeScript teams that want to code against one iMessage interface and keep the option to switch between the supported hosted providers.

Sources

• github.com/jmisilo/imessage-sdk
• github.com/jmisilo/imessage-sdk/blob/main/packages/imessage-sdk/README.md
• github.com/jmisilo/imessage-sdk/blob/main/packages/providers/README.md
• github.com/jmisilo/imessage-sdk/blob/main/packages/chat-adapter/README.md
• github.com/jmisilo/imessage-sdk/blob/main/packages/cli/README.md
• npmjs.com/package/imessage-sdk