Skip to content
imsg.dev

Ship your iMessage assistant in days, not weeks.

Put your AI assistant in the place people already reply. This Python SDK sends and receives iMessages, including images, PDFs, and files, and streams inbound texts live. Ship in a day and make your first $ fast.

Get the SDKSee pricing
$100 off for the first 100 customers (94 left)
Top Quickstart (Python)
from imessage_sdk import IMessageSender
sender = IMessageSender()
sender.send_text(phone_number="+15551234567", text="Hello from Python!")
Typical setup under 5 minutes.
1. Purchase access, then get the repo and examples.
2. Send messages and attachments in minutes.
3. Start the live stream to route conversations.
Send images and files

Share photos, PDFs, and more.

Receive messages live

Handle replies in a live stream.

Cloud compatible

Scale on EC2 Mac or MacStadium.

Any framework

Python SDK and HTTP API; works with any stack.

git clone imessage_sdk

Features that ship products

Instant iMessage sending

Three lines to send. Messages users actually reply to.

Live inbound stream

Live event stream to handle replies as they happen.

Python SDK

Clean, assistant‑focused API for building fast.

Images, PDFs, files

Send and receive images, PDFs, and files in iMessage threads.

HTTP API + TypeScript

Call a simple HTTP API from Node and TypeScript. Works with any stack.

Reliable data access

Snapshot reads from chat.db for stability.

Built for iMessage AI assistants

Fast, personal, and deployable on EC2 Mac/MacStadium so you can ship iMessage AI assistants that users actually reply to.

Why the SDK wins

Skip weeks of glue code. Ship an iMessage AI assistant today.

With the SDK

  • Install → grant → send in minutes
  • Reliable chat.db reads
  • Images/files (read‑write)
  • Built for iMessage AI assistants
  • Cloud‑ready (EC2 Mac/MacStadium)
Get the SDK

DIY

  • Days/weeks to stable send/listen
  • chat.db edge cases
  • Brittle scripts & glue code
  • Permissions/reliability work

What you can build

Personal iMessage AI secretary

Auto‑reply, summarize, schedule, and send attachments, all inside one iMessage thread.

Vertical iMessage AI copilots

Finance, recruiting, sales‑ops, and healthcare intake, with LLM‑backed flows triggered by incoming texts.

SaaS on iMessage

Plug your product into iMessage for reminders, status updates, and approvals.

Team ops iMessage bot

Route on‑call alerts or approvals to group chats (by GUID), log outcomes to your backend.

The code in 3 minutes

Listen & reply (AI assistant)
from imessage_sdk import IMessageClient, IMessageSender
from imessage_sdk.models import IMessage
from openai import OpenAI


llm = OpenAI()                 # configure via env vars
send = IMessageSender()        # ready-to-send helper


def on_message(msg: IMessage):
    if msg.is_from_me or not msg.content:
        return
    # Generate an assistant reply
    reply = llm.responses.create(
        model="gpt-5",
        input=f"Reply helpfully to: {msg.content}"
    ).output_text
    # Reply in the same thread (group or 1:1)
    if msg.chat_guid:
        send.send_text(chat_guid=msg.chat_guid, text=reply)
    elif msg.sender_phone:
        send.send_text(phone_number=msg.sender_phone, text=reply)


client = IMessageClient()       # sane defaults for chat.db
client.start_listening(callback=on_message)
Full setup instructions are included in the private repo after purchase.
No subscription. Lifetime license. Build today.
Get the SDK

There’s an easier way

Ship inside iMessage and use the best chat UI on earth with zero extra work. No new app. No onboarding. People just text back.

Save 30+ hours of setup across the hard parts:
  • Reliable sending from macOS
  • Safe access to the Messages database
  • Images, PDFs, and file attachments
  • Live inbound stream for replies
  • CLI, docs, and copy‑paste examples

Wall of love

“

I turned a small idea into a paid iMessage assistant. People text photos and quick questions, get a fast reply, and I shipped the first version in a day.

Launched an iMessage assistant
“

We moved lead capture into iMessage. Prospects answer the first text, share a screenshot when asked, and the handoff to our team is seamless.

Built a lead capture bot
“

Support now lives in one thread. People send a photo, get a clear next step, and we follow up later in the same chat—no portal required.

Shipped an AI concierge
$100 off for the first 100 customers (94 left)

One price. Lifetime license.

Save hours of repetitive code, ship fast, get profitable.

$549$449
  • Python SDK
  • Outbound + images/PDFs/files (send + receive)
  • Inbound stream (watch/listen)
  • Built for iMessage AI assistants, lead routers, CRMs
  • Optional HTTP API for TypeScript/Node
Get the SDKSee code
Launch offer: $100 off for the first 100 customers (94 left). No subscription. Lifetime license + 12 months of updates. 14‑day refund. Secure Stripe checkout. Taxes/VAT may apply.

Cloud + scale

Run it on Mac VMs (e.g., AWS EC2 Mac or MacStadium). Sign into iCloud, enable Messages, grant permissions once, run the HTTP API + event stream, and sticky‑route conversations to a pool of Mac workers as you grow. AWS Mac has a 24‑hour host minimum; scale via Dedicated Hosts.

Security & privacy

Local on your Mac. Your iCloud account, your machine. No third‑party cloud; you control keys and data. Standard macOS permissions; SIP stays on.

Behind the SDK

Built from a production stack powering real iMessage assistants. The SDK packages the hard parts: reliable chat.db reads, AppleScript sending, permissions flow, and typed models, so you can focus on AI logic and shipping.

FAQ

Is this an official Apple API?

It automates the Messages app on macOS and reads your local chat database.

What do I need to get started?

macOS Sonoma/Sequoia, Python 3.11+, Full Disk Access & Automation permissions.

Private APIs or disable SIP?

No. AppleScript handles sending, and read‑only chat.db powers the inbox with standard macOS permissions. SIP stays on.

Commercial use?

Yes for your own apps; contact for redistribution/OEM.

Cloud?

Yes. Run locally on your Mac or on Mac VMs (EC2 Mac/MacStadium).

Support?

GitHub Issues + email; paid consults available.

Questions? Email hi@imsg.dev
Get the SDK