What does the iMessage tool enable AI assistants to do?

It empowers AI assistants to read your iMessage chat history, send messages to existing conversations, and automatically resolve contact names directly from your macOS system, enhancing automation and interaction.

Can I start new iMessage conversations using an AI assistant with this tool?

No, the `im_send` function is designed only for sending messages to existing iMessage chat threads. It does not support initiating new conversations.

How does the tool resolve phone numbers and emails to contact names?

It reads your Apple AddressBook databases on macOS, normalizing phone numbers and emails to accurately match them with your saved Apple Contacts for more human-like interactions.

What macOS permissions are required for this tool to function?

You'll need to grant Full Disk Access to your terminal app for reading the Messages database, and Contacts permission for name resolution. Messages.app must also be signed in to send messages.

iMessage

Name: iMessage
Author: daveremy

bydaveremy

0•

Productivity & Workflow

Collaboration Tools

Developer Tools

Enables AI assistants to read and send iMessages directly from macOS, with automatic contact name resolution.

This MCP server empowers AI assistants, such as Claude Code, to seamlessly interact with iMessage on macOS. It provides capabilities to read message history, list conversations, search message content, and send messages to existing chats. A key feature is its ability to automatically resolve phone numbers and email addresses to real names from your Apple Contacts, ensuring interactions are with people, not just handles. The tool operates by directly accessing the local Messages database for reading, utilizing Apple's AddressBook for contact resolution, and employing JavaScript for Automation (JXA) to send messages via the Messages.app.

Key Features

01Search message text across all or specific chats

02List recent conversations with participants and details

03Retrieve participants list for any chat with service types (iMessage, SMS, RCS)

04Send messages to existing iMessage chats via Messages.app

050 GitHub stars

06Automatic resolution of phone numbers and emails to Apple Contacts names

07Read iMessage history directly from macOS Messages database

Use Cases

01Allowing AI assistants to manage and respond to iMessage conversations automatically.

02Integrating iMessage communication directly into AI-driven workflows for customer support or personal assistance.

03Enabling AI agents to retrieve information from past iMessage chats based on user queries.