get_chat_transcriptLABSCO 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.
Setup effort
Build from source — git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
USE CASES
01
Summarising a conversation with someone
get_chat_transcript pulls the message history for that phone number so an agent can read and condense it.
02
Looking at messages from a specific period
get_chat_transcript takes a date range, narrowing the transcript to the window that matters.
03
Checking what was shared in a thread
The transcript includes attachment information, so an agent can tell which messages carried files even when the files are missing.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
Python 3.6+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
cd imessage-query-fastmcp-mcp-server
pip install -r requirements.txt
fastmcp install imessage-query-server.py --name "iMessage Query"MCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"imessage-query": {
"command": "uv",
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"<YOUR_PATH_TO_REPO>/imessage-query-server.py"
]
}
}
}
