iMessage Query MCP Server
by hannesrudolph
This MCP server provides safe access to your iMessage database, enabling LLMs to query and analyze iMessage conversations. It uses the FastMCP framework and the imessagedb library for phone number validation and attachment handling.
Last updated: N/A
What is iMessage Query MCP Server?
The iMessage Query MCP Server is a tool that allows Large Language Models (LLMs) to securely query and analyze your iMessage database on macOS using the Model Context Protocol (MCP). It leverages the FastMCP framework and the imessagedb library to provide a safe and efficient way to extract information from your iMessage conversations.
How to use iMessage Query MCP Server?
To use the server, you first need to clone the repository and install the dependencies using pip install -r requirements.txt. Then, you can install the server for either Claude Desktop using fastmcp install imessage-query-server.py --name "iMessage Query" or the Cline VSCode plugin by configuring the plugin settings with the appropriate command and arguments, pointing to the location of the imessage-query-server.py file.
Key features of iMessage Query MCP Server
Safe access to iMessage database
Phone number validation
Attachment handling
Date range filtering
Read-only access
Progress output suppression
Use cases of iMessage Query MCP Server
Analyzing conversation history with LLMs
Extracting specific information from iMessage conversations
Building LLM-powered applications that interact with iMessage data
Generating summaries of conversations
Identifying trends in messaging behavior
FAQ from iMessage Query MCP Server
Does this server modify my iMessage database?
Does this server modify my iMessage database?
No, the server provides read-only access to the iMessage database, ensuring that your data remains unchanged.
What kind of data can I access with this server?
What kind of data can I access with this server?
You can access message text, timestamps, and attachment information for specific phone numbers, with optional date filtering.
Is my phone number data secure?
Is my phone number data secure?
Yes, the server uses the phonenumbers library to validate and format phone numbers, ensuring proper handling of sensitive information.
Do I need to configure any environment variables?
Do I need to configure any environment variables?
No, the server automatically locates the iMessage database in the default macOS location, so no environment variables are required.
What if an attachment is missing?
What if an attachment is missing?
The server includes safe attachment handling with missing file detection, preventing errors when querying conversations with missing attachments.