Contacts & CRM
sendIMessage
Send iMessage
Send an iMessage for a person to a client's Messages chat (group or 1:1), through your own Mac signed in to Messages via MachineSync: an AppleScript send to that chat id, never typed into a browser.
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "text the Cake Ann group", and it calls sendIMessage.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"onBehalfOf": "<onBehalfOf>",
"text": "<text>"
},
"name": "sendIMessage"
}Arguments
acknowledgedstring[]optionalBuilt-in outbound checks you are knowingly relaxing for THIS send. Pass ["humble-ask"] only when the user wants the text sent as written after the humble-ask refusal; acknowledgedReason is required with it.acknowledgedReasonstringoptionalWhy the acknowledged check is relaxed for this send, in one line. Logged with the rail and the phrases it let through.channelstringoptionalPass "imessage" only to send on iMessage knowingly when the person's channel of record is something else.chatIdstringoptionalA Messages chat id already on record. Pass this or contactId.closesTaskIdstringoptionalThe task or promise row this message closes, for the ledger.contactIdstringoptionalThe contact to message on their recorded chat.onBehalfOfstringrequiredThe person Ora speaks for, by the name the recipient knows.overridebooleanoptionalSend inside the 14-day window, without outreach consent, or past an unconfirmed earlier send the user checked in Messages. Attributable; only on the user's explicit word.signedAsstringoptionalThe person's own name, only when they said to sign this send with it.textstringrequiredThe exact message body for THIS send.transactionalobjectoptionalThe person's own record this message confirms. Verified server-side as yours and naming this recipient, else refused.
Returns
The registry does not declare a return shape.
Declared limits
onBehalfOf: minimum length 1text: minimum length 1
Ask for it
The Cloud routes these requests to this verb.
- text the Cake Ann group
- iMessage Heidi for me
- send this to the client's group chat
Pair it with
The verbs that finish the job.
Questions
What does sendIMessage do?
Send an iMessage for a person to a client's Messages chat (group or 1:1), through your own Mac signed in to Messages via MachineSync: an AppleScript send to that chat id, never typed into a browser. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use sendIMessage from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "text the Cake Ann group", and it calls sendIMessage.
Is sendIMessage safe to let an AI call?
sendIMessage widens who can see or receive something, so the owner approves every call explicitly. An AI cannot approve it for itself. It reaches a system outside The Cloud on your behalf.
Connect
One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.