skills.rest
ericblue
ericblueCOMMUNITY
Explore all skills by this author →
Website𝕏@ericblueGitHub

mag-messages

Send, read, and search Apple Messages via a local HTTP REST API gateway.

88|10|Updated Jan 30, 2026
Search Tags:#automation#api#macos#messages#sms#imessage
One-click install
npx skills add https://github.com/ericblue/mac-agent-gateway --skill mag-messages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mag-messages
Source: https://github.com/ericblue/mac-agent-gateway/tree/main/skills/mag-messages
Command: npx skills add https://github.com/ericblue/mac-agent-gateway --skill mag-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows AI agents to interact with Apple Messages (iMessage and SMS) on macOS, overcoming the limitations of direct access and TCC permissions.

Core Features & Use Cases

  • Send Messages: Compose and send iMessages or SMS to contacts.
  • Read & Search: Retrieve message history, list threads, and search conversations for specific content or links.
  • Manage Contacts: Maintain a cache of contacts for easier resolution.
  • Use Case: An AI assistant can now "Find the last 20 links Jane sent me" or "Create a reminder for tomorrow at 9am to call the dentist" by interacting with your Messages app.

Quick Start

Use the mag-messages skill to send a message to John Doe at +15551234567 saying "Hello!".

Frequently Asked Questions about mag-messages

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

FAQPage Schema
How do I send iMessage or SMS texts from an AI agent on macOS?▼

To send iMessage or SMS texts from an AI agent on macOS, this Skill uses a local HTTP REST API gateway to manage Apple Messages. It enables automated sending, reading, and searching of message threads without direct TCC permission access.

Can I search Apple Messages for specific links and attachments via an API?▼

Yes, you can search Apple Messages for specific links and attachments via an API. The Skill retrieves message history, searches conversations for specific content, and extracts links sent by contacts through the local HTTP gateway.

Do I need a specific gateway running to automate Messages on macOS?▼

Yes, automating Messages on macOS requires the Mac Agent Gateway to be running and configured with an API key. This local HTTP REST gateway acts as the bridge allowing AI agents to interact with your messages.

How does an AI assistant resolve contacts when sending iMessages?▼

An AI assistant resolves contacts when sending iMessages by using a maintained contact cache. This allows the API to map recipient details accurately when composing and sending SMS or iMessage communications.

What are the limitations of using an API to control Apple Messages?▼

Using an API to control Apple Messages is limited by its dependence on a local macOS environment and the Mac Agent Gateway. It operates locally via HTTP REST, meaning it cannot function without this specific local infrastructure and active configuration.

Related Skills

Explore More Software Engineering Skills→
tharunramagiritharunramagiri

add-discord

Integrate Discord bot functionality via the Chat SDK bridge.

Community
Intermediate
DotNetAgeDotNetAge
32

notify

Display macOS system notifications from JSON payloads via osascript.

Community
Basic
PolealphaPolealpha

imsg

List, fetch, monitor, and send iMessage and SMS chats from a macOS terminal.

Community
Basic
NJX-njxNJX-njx
55

imsg

List, fetch, watch, and send iMessage or SMS messages from the macOS command line.

Community
Basic