---
title: "iMessage agents — setup, permissions and first task — AgentSky"
description: "Connect iMessage by sending the pairing text to the number shown in AgentSky. The channel uses a US number and reaches the agent you select in the dashboard."
url: https://agentsky.dev/channels/imessage
---

# iMessage

Connect iMessage by sending the pairing text to the number shown in AgentSky. The channel uses a US number and reaches the agent you select in the dashboard.

[Repo](https://agentsky.dev/auth/start?returnTo=%2Fchannels%2Fimessage%3Fresume%3D1)

A task starts here in your browser. To receive messages through iMessage, [connect iMessage on your Channels page](https://agentsky.dev/channels?connect=imessage) . Channel setup opens separately; it does not automatically bind this new task.

Setup

## Connect iMessage and verify your first task.

An AgentSky agent and Messages on an iPhone or Mac that can send to the displayed US number.

01

### Open Connect iMessage

On your Channels page, select Connect iMessage.

02

### Send the exact pairing text

Use Open Messages, scan the QR with your iPhone, or copy the displayed number and code. Send the text from the account you intend to use.

03

### Confirm a task response

After pairing, ask for a checklist from a short set of notes. Verify that the selected agent replies before relying on the connection.

Before you connect

## Know what this connection does.

A channel provides a conversation entry point. Configure task-specific tools, credentials and permissions separately, and review model and runtime pricing before running work.

- Pairing across devices The setup offers a QR, an Open Messages link, and copy controls. Use the fallback that works on your device; opening a link alone does not complete pairing.
- A US destination number The current channel advertises a US number. Confirm your device and messaging service can reach the number shown during setup.
- Keep pairing details private Use the current code from your own setup session. Do not share pairing screenshots containing a live code.

## iMessage setup questions

## Related resources

[Claude Code + iMessageUse Claude Code from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/claude-code/channels/imessage) [Codex + iMessageUse Codex from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/codex/channels/imessage) [OpenClaw + iMessageUse OpenClaw from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/openclaw/channels/imessage) [OpenCode + iMessageUse OpenCode from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/opencode/channels/imessage) [Hermes + iMessageUse Hermes from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/hermes/channels/imessage) [Kimi Code + iMessageUse Kimi Code from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/kimi-code/channels/imessage) [DeepSeek Harness + iMessageUse DeepSeek Harness from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/dsh/channels/imessage) [pi + iMessageUse pi from iMessage after testing the same agent in the shared Composer.](https://agentsky.dev/agents/pi/channels/imessage) [All channelsCompare setup methods and supported conversation surfaces.](https://agentsky.dev/channels) [ConnectorsAuthorize application access separately.](https://agentsky.dev/connectors) [PricingReview model and runtime charges.](https://agentsky.dev/pricing)

## Choose the agent that answers in iMessage.

[Connect iMessage](https://agentsky.dev/channels?connect=imessage)

## Frequently asked questions

### How does iMessage pairing work?

Open setup in AgentSky and send the displayed pairing text to its US destination number from the Messages account you want to connect.

### Do I need to own a US phone number?

The current setup specifies a US destination number to reach. It does not establish a requirement that your own number be US-based. Your device and messaging service must be able to reach that destination.

### Does scanning the QR code complete pairing?

No. Use the QR, Open Messages link or copied details to send the displayed pairing message. Opening Messages without sending does not complete that step.

### Which account should send the pairing message?

Use the Messages account you intend to use for future conversations with the agent. Verify the connected state and a reply from that account.

### Which agent will answer my iMessage requests?

The dashboard determines the agent binding. Confirm the selected agent in AgentSky’s channel settings before testing the conversation.

### Does connecting iMessage give access to my other apps?

No. The channel is for exchanging messages with the agent. Private application access requires separate connector authorization.

### Does a messaging channel make agent usage free?

No. A channel is a way to communicate with an agent. Model, tool and runtime usage remain subject to the applicable AgentSky charges.

### Can I complete pairing by copying the number alone?

No. The flow requires sending the displayed pairing text to that number. Copying or opening the destination is only preparation; the outgoing pairing message is the required action.

### What should I check if pairing never completes?

Confirm the destination number, exact displayed pairing text and the Messages account used to send it. Verify that the message was sent, then check the connection state before sending a normal task.

### Does iMessage setup also configure WhatsApp or Telegram?

No. Each channel has its own account and connection flow. iMessage pairs the Messages conversation with the selected agent; other channels must be configured separately.

---

Markdown copy of https://agentsky.dev/channels/imessage. Every agentsky.dev page has one: add `.md` to its address or send `Accept: text/markdown`. Start from https://agentsky.dev/llms.txt.
