imessage

Read and send iMessages via sqlite3 and AppleScript on macOS.

54|15|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/dvdsgl/claude-imessage --skill imessage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/dvdsgl/claude-imessage/tree/main/skills/imessage
Command: npx skills add https://github.com/dvdsgl/claude-imessage --skill imessage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually managing iMessages for automated responses, data extraction, or continuous conversations is time-consuming and inefficient. This Skill empowers Claude to handle iMessage interactions autonomously, freeing you from constant monitoring and manual replies.

Core Features & Use Cases

  • Read Messages: Access and analyze conversation history directly from the Messages database for comprehensive context.
  • Send Messages & Files: Compose and send messages, including attachments, to contacts or group chats via iMessage or SMS.
  • Monitor New Messages: Automatically detect and process incoming messages from specified contacts, enabling continuous, autonomous conversations.
  • Use Case: Set up an AI assistant that automatically responds to customer inquiries via iMessage, checks for follow-up questions, and provides updates without human intervention, ensuring timely communication around the clock.

Quick Start

Use the imessage skill to read my 5 most recent messages from 4155551234 and then send a reply saying 'Got it, I'm on it!'

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I automate reading and sending iMessages on macOS?

Automate iMessage reading and sending by accessing the Messages SQLite database and invoking AppleScript through a Bash toolchain. This Skill reads conversation history from ~/Library/Messages/chat.db, detects new messages, sends replies to contacts or group chats, and processes attachments—enabling autonomous message workflows without manual intervention.

Can I access my iMessage conversation history programmatically?

Yes, this Skill accesses iMessage conversation history directly from the Messages SQLite database on macOS, extracting message content, timestamps, and sender information. You can query specific contacts, retrieve recent messages, and analyze full conversation context for automated responses or data extraction.

How do I monitor incoming iMessages and trigger automated responses?

Set up continuous monitoring of incoming iMessages by checking for new messages from specified contacts, then automatically compose and send replies via iMessage or SMS. This enables unattended AI assistants to respond to customer inquiries, acknowledge follow-ups, and provide updates in real time.

Does this work with group chats and message attachments?

Yes, this Skill sends messages to both individual contacts and group chats, and handles attachments including file processing. It supports a complete iMessage workflow on macOS including file extraction and multi-recipient messaging via the Messages app.

What macOS environment setup do I need for iMessage automation?

You need macOS with the Messages app, SQLite access to ~/Library/Messages/chat.db, and AppleScript capability. The Skill uses a Bash and SQLite toolchain—no additional dependencies beyond the native macOS messaging infrastructure.

Can I use this for customer support automation via iMessage?

Yes, this Skill is designed for autonomous customer support workflows—reading incoming inquiries from iMessage, generating responses, sending replies automatically, and checking for follow-ups. It enables 24/7 AI-driven customer communication without manual monitoring.