iMessage MCP Server

Example Use Cases

• 1

  Search and retrieve historical iMessage conversations by text, contact, or date range to provide contextual answers or summarize past discussions.

• 2

  Recent message context and conversation lists to maintain continuity in multi-turn dialogs or to surface recent user interactions.

• 3

  Resolve contact names to iMessage handles (phone numbers/emails) by searching macOS Contacts to correctly target or reference conversations.

Description

This repository provides a Deno monorepo with a core library to read the macOS iMessage database and an MCP (Model Context Protocol) server to expose that data to LLMs and agent applications. It supports searching messages by text, contact, or date range, listing chats, retrieving recent messages, and searching macOS Contacts with handle correlation. The server is read-only, runs locally on macOS, includes pagination metadata for results, and can integrate with tools like Claude Desktop for private, local access to message context.