imessage

Send and receive iMessages and SMS via the imsg command-line tool.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/samuelbonifacio015/obsidian-notes --skill imessage-samuelbonifacio015
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/samuelbonifacio015/obsidian-notes/tree/main/obsidian/Sistema/Skills/Vendor/apple/imessage
Command: npx skills add https://github.com/samuelbonifacio015/obsidian-notes --skill imessage-samuelbonifacio015

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines sending and receiving iMessages/SMS on macOS, eliminating the need for manual messaging and enabling a command-line interface for these functions.

Core Features & Use Cases

  • iMessage/SMS Access: Interact with iMessage and SMS directly through the imsg command-line tool.
  • MacOS Integration: Seamlessly integrates with macOS Messages.app.
  • Use Case: Quickly send a message to a contact or check the history of a conversation without opening the Messages app.

Quick Start

Use the imsg skill to send an iMessage to +14155551212 with the text "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 from the macOS command line?

You can send iMessages from the macOS command line by using the imsg CLI tool to interact directly with the Messages.app. This Skill enables command-line messaging by passing recipient numbers and text content to the imsg command.

Can I check SMS conversation history without opening the Messages app?

Yes, you can check SMS conversation history without opening the Messages app by using the imsg command-line tool. This Skill provides command-line access to macOS Messages.app to retrieve conversation histories directly in your terminal.

Do I need macOS to use the imsg command-line tool for messaging?

Yes, you need macOS to use the imsg command-line tool for messaging because it integrates directly with the native Messages.app. The Skill requires macOS with Messages.app signed in to authenticate recipients and send messages.

Does the imsg CLI support selecting between iMessage and SMS?

Yes, the imsg CLI supports selecting between iMessage and SMS by offering service selection features. This Skill enables command-line interaction with macOS Messages.app, allowing you to specify whether a message is sent via iMessage or SMS.

What are the limitations of sending iMessages via command line on macOS?

Limitations of sending iMessages via command line include requiring macOS with Messages.app actively signed in and the imsg CLI dependency installed. The Skill cannot function without this specific environment and the native Messages.app integration.

How does recipient authentication work when sending SMS on macOS?

Recipient authentication when sending SMS on macOS is handled through the Messages.app integration. The Skill supports recipient authentication and service selection to ensure messages are correctly routed to verified contacts via iMessage or SMS.