imessage

Read and send iMessages through the macOS Messages application.

Updated May 7, 2026
One-click install
npx skills add https://github.com/BeltDoor/aios-template --skill imessage-beltdoor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/BeltDoor/aios-template/tree/main/.king-intelligence/plugins/king-intelligence/skills/imessage
Command: npx skills add https://github.com/BeltDoor/aios-template --skill imessage-beltdoor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill removes the friction of checking, searching, and responding to iMessages by connecting an AI assistant with the Mac Messages app while keeping message handling on-device.

Core Features & Use Cases

  • Message Reading: Retrieve recent conversations, search message history, and resolve phone numbers or emails to contact names from the local Messages database.
  • Reply Drafting and Sending: Draft responses in the user's voice and send approved messages through the Messages app after explicit confirmation.
  • Use Case: A user can ask for recent texts from a contact, review the conversation context, draft a reply, and approve the exact message before it is sent.

Quick Start

Use the imessage skill to check my latest messages and help me draft a reply to the most recent conversation.

Frequently Asked Questions about imessage

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

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

Automating iMessage management on macOS uses AppleScript to read conversations and send approved texts through the local Messages database. This removes manual searching and drafting by letting an AI assistant handle message retrieval and delivery.

Can I draft replies from my Mac Messages app without manual typing?

Drafting replies from the Mac Messages app is possible by retrieving recent conversation context and generating a response in your voice. The drafted message requires explicit confirmation before it is sent through the Messages application.

Does macOS automation for texting require access to my local Contacts database?

macOS texting automation requires access to the local Contacts database to resolve phone numbers and emails to contact names. This allows the system to accurately find messages from specific people when checking conversation history.

What is the best way to search message history for a specific contact on a Mac?

The best way to search message history on a Mac is by querying the local Messages database. This approach retrieves recent conversations and resolves contact names automatically, reducing the friction of manual message searching.

Are there limitations to using AppleScript for iMessage automation on macOS?

AppleScript iMessage automation is limited to on-device message handling and requires a Mac with the Messages app installed. Because it relies on local databases, it cannot retrieve conversations or send texts from devices without direct macOS access.

Do I need to approve messages before the iMessage automation sends them?

Messages drafted by the iMessage automation require your explicit approval before they are sent. This ensures you review the exact message text generated from the conversation context before delivery through the Messages app.