send-imessage_skill

Overview

This skill sends iMessages through the macOS Messages app using AppleScript. It formats phone numbers (adds +1 for US numbers), constructs an AppleScript send command, and executes it via osascript. The skill supports English, Chinese, and emoji content. It requires the Messages app to be logged in to iMessage.

How this skill works

The skill extracts the recipient phone number and message text from the request, normalizes US numbers by adding the +1 prefix, and builds an AppleScript snippet. It runs the snippet with osascript to activate Messages and send the text to the specified buddy. If AppleScript is blocked, macOS Accessibility or privacy permissions may need to be enabled.

When to use it

• Send a quick text or iMessage from a macOS environment
• Automate one-off messages from scripts or tools running on macOS
• Send messages that include Chinese, English, or emoji content
• Deliver an SMS/iMessage to a specific phone number (US numbers get +1)

Best practices

• Ensure the Messages app is logged into an iMessage-capable Apple ID before sending
• Provide full phone numbers; for US numbers, omit or include area code — the skill will add +1 if missing
• Keep messages short and avoid sensitive credentials in plain text
• Grant Accessibility and Automation permissions if AppleScript commands fail
• Test with a known number first to confirm delivery and permissions

Example use cases

• Send a meeting reminder to a colleague’s phone from a macOS automation script
• Deliver a quick verification code to your own phone during testing
• Send multilingual alerts (English and Chinese) from a desktop tool
• Script notifications that include emoji for clearer status updates