imessage-query-fastmcp-mcp-server
If you are the rightful owner of imessage-query-fastmcp-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP).
The iMessage Query MCP Server is designed to facilitate secure and efficient access to iMessage databases using the Model Context Protocol (MCP). Built on the FastMCP framework and utilizing the imessagedb library, this server allows Language Model Models (LLMs) to query and analyze iMessage conversations. It ensures proper phone number validation and handles attachments safely. The server is compatible with macOS, as it requires access to the iMessage database, and supports Python 3.6 or higher. The server's dependencies include fastmcp for building MCP servers, imessagedb for accessing the macOS Messages database, and Google's phonenumbers library for phone number validation. The server can be installed for use with Claude Desktop or the Cline VSCode plugin, providing flexibility in deployment.
Features
- Safe access to iMessage database with read-only permissions.
- Phone number validation using Google's phonenumbers library.
- Attachment handling with missing file detection.
- Date range filtering for message retrieval.
- Progress output suppression for clean JSON responses.
Tools
get_chat_transcript
Retrieve message history for a specific phone number with optional date filtering, including message text, timestamps, and attachment information.
