Get BlueBubbles server info and health status.

Ping the BlueBubbles server to check connectivity.

List iMessage conversations, sorted by most recent activity.

Args: limit: Max number of chats to return (default 25). offset: Pagination offset.

Get details for a specific chat, including participants.

Args: chat_guid: The chat GUID (e.g. 'iMessage;-;+15551234567' or 'iMessage;+;chat123').

Get messages from a specific chat.

Args: chat_guid: The chat GUID. limit: Max messages to return (default 25). offset: Pagination offset. sort: 'ASC' or 'DESC' (default DESC = newest first). after: Only messages after this epoch-ms timestamp. before: Only messages before this epoch-ms timestamp.

Get recent messages across all chats within a time window.

Args: minutes: How far back to look (default 60 minutes). limit: Max messages to return (default 50).

Get all chats with unread messages, including their latest messages.

Args: message_limit: Number of recent messages to include per unread chat (default 5).

Mark a chat as read (sends read receipt visible to the other person).

Args: chat_guid: The chat GUID.

Mark a chat as unread.

Args: chat_guid: The chat GUID.

Show a typing indicator in a chat (visible to the other person).

Args: chat_guid: The chat GUID.

Stop the typing indicator in a chat.

Args: chat_guid: The chat GUID.

Delete an entire chat conversation. This is irreversible.

Args: chat_guid: The chat GUID to delete.

Send a text message to an existing chat.

Args: chat_guid: The chat GUID to send to. message: The message text. reply_to_guid: Optional message GUID to reply to (creates a thread).

Send a message to a phone number or email, creating a new chat if needed.

Args: address: Phone number (e.g. '+15551234567') or email address. message: The message text. service: 'iMessage' or 'SMS' (default iMessage).

Send a tapback reaction to a message.

Args: chat_guid: The chat GUID containing the message. message_guid: The GUID of the message to react to. reaction: One of: love, like, dislike, laugh, emphasize, question. Prefix with '-' to remove (e.g. '-love').

Edit a previously sent message.

Args: message_guid: GUID of the message to edit. new_text: The new message text.

Unsend (retract) a previously sent message.

Args: message_guid: GUID of the message to unsend.

Search messages by text content and/or filter by chat and time range.

Args: query: Text to search for in message bodies. chat_guid: Limit search to a specific chat. limit: Max results (default 25). offset: Pagination offset. after: Only messages after this epoch-ms timestamp. before: Only messages before this epoch-ms timestamp.

Get a single message by its GUID, including chat and attachment info.

Args: message_guid: The message GUID.

Get all contacts from the server.

Look up contacts by phone numbers or email addresses.

Args: addresses: List of phone numbers or emails to look up.

Check if a phone number or email is registered for iMessage.

Args: address: Phone number or email to check.

Check if a phone number or email is registered for FaceTime.

Args: address: Phone number or email to check.

Rename a group chat.

Args: chat_guid: The group chat GUID. name: New display name for the group.

Add a participant to a group chat.

Args: chat_guid: The group chat GUID. address: Phone number or email of the person to add.

Remove a participant from a group chat.

Args: chat_guid: The group chat GUID. address: Phone number or email of the person to remove.

Leave a group chat.

Args: chat_guid: The group chat GUID to leave.

List all scheduled (future) messages.

Schedule a message to be sent at a future time.

Args: chat_guid: The chat GUID to send to. message: The message text. scheduled_for: When to send, as epoch milliseconds.

Delete a scheduled message.

Args: schedule_id: The ID of the scheduled message to cancel.

Get metadata for an attachment (filename, mime type, size, etc.).

Args: attachment_guid: The attachment GUID.

Download an attachment and return it as base64-encoded data.

Args: attachment_guid: The attachment GUID.

Send a file attachment to a chat.

Args: chat_guid: The chat GUID to send to. data_base64: The file contents as a base64-encoded string. filename: The filename (e.g. 'photo.jpg'). mime_type: MIME type (e.g. 'image/jpeg'). Defaults to 'application/octet-stream'.