chat-adapter-imessage

Integrate the Vercel AI SDK with iMessage for message posting, editing, deletion, reactions, and real-time listening.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chat-adapter-imessage, @photon-ai/imessage-kit, @photon-ai/advanced-imessage-kit, and includes references (resource) components.

What problem does it solve?

This Skill bridges the gap between the Vercel AI SDK and iMessage, enabling AI agents and chatbots to communicate directly with users via Apple Messages.

Core Features & Use Cases

  • Seamless Integration: Connects the Vercel AI SDK (Chat SDK) to iMessage using a robust adapter.
  • Flexible Deployment: Supports both local mode (running on your Mac) and remote mode (leveraging Photon's production infrastructure).
  • Core Messaging Actions: Handles sending, editing, and deleting messages, as well as adding reactions (tapbacks).
  • Real-time Communication: Enables real-time message reception through a gateway listener.
  • Use Case: Build an AI assistant that can respond to customer inquiries received via iMessage, or create a personal AI companion that interacts with you through Apple Messages.

Quick Start

Use the chat-adapter-imessage skill to create an iMessage adapter for the Vercel AI SDK.

Frequently Asked Questions about chat-adapter-imessage

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

FAQPage Schema
How do I connect an AI agent to iMessage using the Vercel AI SDK?

You can connect an AI agent to iMessage by using a chat adapter that bridges the Vercel AI SDK with Apple Messages, supporting message posting, editing, deletion, and reactions. This enables AI-driven conversational agents for iMessage communication.

Can I run an iMessage chatbot locally on my Mac or do I need a remote server?

You can deploy your iMessage chatbot in either local mode running directly on your Mac or remote mode leveraging production infrastructure. Both operational modes support real-time message reception through a gateway listener.

Does the iMessage adapter support editing and deleting messages sent by the AI?

Yes, the iMessage adapter implements core messaging methods that handle sending, editing, and deleting messages. It also supports adding reactions, known as tapbacks, to facilitate interactive AI conversations.

What is the best way to build a personal AI companion that replies via Apple Messages?

The best way to build an AI companion for Apple Messages is to use a chat adapter that integrates the Vercel AI SDK with iMessage. This setup handles real-time message listening and automated conversational responses.

Do I need a Mac to receive real-time iMessages for my AI chatbot?

A Mac is required if you choose to operate the iMessage adapter in local mode. If you prefer not to use a Mac, you can run the adapter in remote mode using production infrastructure to maintain real-time message gateway listening.