Labsco
MCP SERVER

iMessage Query

by hannesrudolph

Query your macOS iMessage history from the conversation — safely, read-only, with proper phone-number handling.

Team Chat Platforms
Summary
A safe, read-only window onto your own iMessage history for an assistant to search and summarise.

It validates phone numbers with a proper library and handles missing attachment files gracefully, and because it only reads, an agent can pull a transcript for a contact over a date range without any risk of altering the conversation.

What it is

A server built on FastMCP that gives an assistant read-only access to the macOS Messages database, so it can pull and analyse a conversation with a given contact, complete with attachment details and date filtering.

What you get
  • get_chat_transcript retrieves the message history for a phone number, with optional date-range filtering — message text and timestamps, attachment information, and validated phone numbers
Requirements

macOS, since it reads the local Messages database, and Python. No environment configuration — it finds the database in its default location. Access is read-only.