imessage

Send and receive iMessages programmatically via WebSockets and AppleScript.

14|2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/photon-hq/skills --skill imessage-photon-hq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/photon-hq/skills/tree/main/skills/imessage
Command: npx skills add https://github.com/photon-hq/skills --skill imessage-photon-hq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables programmatic interaction with iMessage, allowing for the creation of AI agents, automations, and conversational applications directly within the iMessage ecosystem.

Core Features & Use Cases

  • Send and Receive Messages: Programmatically send text, images, files, and more, and receive incoming messages in real-time.
  • Advanced Messaging Features: Supports effects, reactions, group chat management, scheduled messages, and more.
  • Use Case: Build an AI chatbot that can respond to iMessage conversations, automate sending scheduled reminders to contacts, or integrate iMessage notifications into your existing workflows.

Quick Start

Use the imessage skill to send a message to +1234567890 saying hello.

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessages programmatically through an API?

You can send iMessages programmatically by using a managed API for production or AppleScript for self-hosted infrastructure. This enables automated sending of text, images, files, and scheduled messages directly to contacts.

Can I build a chatbot that receives iMessages in real-time?

Yes, you can build a chatbot that receives iMessages in real-time by utilizing WebSocket connections. This allows your automated agents to process incoming conversations and respond instantly with text or rich media.

Does this iMessage API support group chats and message reactions?

Yes, this iMessage API supports advanced messaging features including group chat management, message reactions, and visual effects. You can programmatically manage group conversations and apply reactions to incoming messages.

Do I need a Mac to self-host an iMessage automation server?

Self-hosted iMessage automation requires AppleScript, which necessitates a macOS environment to execute operations. Alternatively, you can use the managed API infrastructure to send messages without self-hosting on Apple hardware.

What is the best way to automate scheduled iMessage reminders?

The best way to automate scheduled iMessage reminders is by using this Skill's built-in scheduled messaging feature. It allows your workflows to programmatically queue and dispatch timed text messages to designated contacts.

Are there limitations when using AppleScript vs a managed API for iMessage?

AppleScript limits iMessage operations to self-hosted macOS environments, while the managed API provides production-ready infrastructure. Your choice depends on whether you need local execution or scalable cloud deployment for your automations.