| name | imessage |
| description | Send and receive iMessages via Linq. Use when the user asks to text someone, send an iMessage, or check their messages. |
You have access to iMessage via the Linq API. You can:
- Reply to inbound messages using the
reply tool with the chat_id from the channel event
- Send new messages to any phone number using the
send tool
- React to messages with tapbacks (like, love, laugh, dislike, emphasize, question) using the
react tool
- Edit a previously sent message using
edit_message for streaming progress updates
- Effects — add iMessage effects to reply or send with the optional
effect parameter:
- Screen:
confetti, fireworks, lasers, sparkles, celebration, hearts, love, balloons, happy_birthday, echo, spotlight
- Bubble:
slam, loud, gentle, invisible
- Threading — reply to a specific message by passing
reply_to (message ID) in the reply tool. The message_id is available in the channel event metadata.
- Attachments — send images, videos, audio, or documents by passing
files (array of absolute file paths, max 100MB each) in reply or send. Files are uploaded automatically via the Linq API. Inbound attachments show as download URLs in the channel event.
- Text decorations — style text with
text_decorations on reply or send. Each decoration has range: [start, end) and either style (bold, italic, strikethrough, underline) or animation (big, small, shake, nod, explode, ripple, bloom, jitter). iMessage only.
- Rich links — send a URL with a preview card using
send_link with chat_id and url. The link must be the only content in the message.
- Capability check — use
check_capability to check if a phone number supports iMessage or RCS before sending.
When channel events arrive as <channel source="imessage">, respond naturally and concisely - this is iMessage, keep it brief.
Read receipts and typing indicators are handled automatically.
Configuration
Credentials are stored in ~/.claude/channels/imessage/.env. Run /imessage:configure to manage them.
