Imessage-Kit

Visit Tool

imessage-kit is an Open Source AI Agents & Automation tool that provides a type-safe iMessage SDK for macOS. It enables reading, sending, and automating iMessage conversations for building AI agents and automation tools.

Claim this tool

No Views Yet

At a glance

Pricing

Open Source

Free tier

Yes

API

Yes

Skill level

Technical

About

What is imessage-kit?

imessage-kit is a type-safe, elegant iMessage SDK specifically designed for macOS, offering zero dependencies for streamlined development. It provides comprehensive functionalities for reading, sending, and automating iMessage conversations, making it ideal for developers building AI agents, automation tools, and chat-first applications. Key features include sending text, images, and files, querying messages, listing chats, and real-time watching of iMessage events. The SDK supports a plugin system for custom logic and robust error handling with typed codes. It requires Full Disk Access to function and offers clear semantics for sending messages and observing their delivery status within the chat.db.

Best used for

Ideal for developers who need to programmatically interact with iMessage on macOS, build AI-powered chat agents, and automate message-based workflows. Especially valuable for creating custom integrations or tools that require reading and sending messages in real-time without external dependencies.

Common actions

automate messaging

build AI agents

integrate iMessage

manage iMessage conversations

develop macOS applications

collaborationautomated workflowopen-sourcedeepfakelow-code/no-codeworkflowsface swapping"AI Agents"github copilot

Capabilities

Key features

Send iMessage text
Send iMessage attachments
Query iMessage history
List iMessage chats
Real-time iMessage watching
Plugin system
Type-safe SDK

Target Audience

developer

Integrations

Not yet documented

Pricing & Plans

Open Source

Free

FAQs

What are the system requirements for imessage-kit?

imessage-kit requires macOS to function, as it interacts directly with the native iMessage application and its underlying database. Additionally, it needs Full Disk Access granted to the IDE or terminal running the SDK to read the chat.db file.

Can imessage-kit send messages to group chats?

Yes, imessage-kit supports sending messages to group chats. It is recommended to use chat IDs surfaced by the SDK itself, for example, from `listChats()` or the watcher's `onGroupMessage` event, rather than manually constructing them.

Does imessage-kit confirm message delivery?

The `sdk.send()` method resolves when the AppleScript invocation exits successfully, but it does not confirm the message has landed in chat.db or been delivered. To observe delivery, you should subscribe to `onFromMeMessage` via the watcher, which fires for every 'from-me' row observed in the database.

Trending

Subcategories trending in AI Agents & Automation

AI Frameworks & Infra Chatbots & Conversational AI Workflow Agents Personal Assistants RAG & Document AI Voice Agents

Trending

Explore

Browse AI tools by category

Content & Design Productivity & Business Coding & Development AI Agents & Automation Research & Education Wellness & Lifestyle Career Development Marketing & Growth Data & Analytics Customer Support & CX Finance E-commerce