iMessage Query MCP Server

iMessage Query MCP Server

McpLlmMcpServerPythonImessageFastmcpJavascriptGoRubyRCommunication

About This Server

An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP). This server is built with the FastMCP framework and the imessagedb library, enabling LLMs to query and analyze iMessage conversations with proper phone number validation and attachment handling.

Server Information

šŸ“‹ Overview:

This webpage is the GitHub repository for an iMessage Query MCP (Model Context Protocol) Server. It provides secure access to iMessage databases, enabling Large Language Models (LLMs) to query and analyze conversations with phone number validation and attachment handling. It utilizes the FastMCP framework and the imessagedb library.


⭐ Key Points:
* Provides access to iMessage data for LLMs.
* Built using FastMCP and imessagedb.
* Includes phone number validation and attachment handling.
* Supports installation in Claude Desktop and Cline VSCode Plugin.

* Includes safety features such as read-only access and data validation.


šŸ” Main Findings:
* The project offers a secure way for LLMs to interact with iMessage data.
* The server uses established libraries for data access and validation.
* Installation is flexible, supporting different LLM development environments.

* Development documentation is included to help customize and enhance the server.


šŸ“Š Details:
* System Requirements: macOS and Python 3.6+.
* Key Dependencies: fastmcp, imessagedb, phonenumbers.
* MCP Tools: `getchattranscript` for message history retrieval.
* Installation Options: fastmcp install for Claude Desktop and Cline VSCode Plugin.
* Safety Features: Read-only database access, phone number validation, safe attachment handling, date range validation, progress output suppression.
* Development Documentation: iMessage database structure and imessagedb library details in `/dev_docs/imessagedb-documentation.txt`.

* No environment variables required for basic setup.


šŸŽÆ Conclusion:
The iMessage Query MCP Server offers a solution for LLMs to analyze iMessage data securely. It combines necessary libraries, flexible installation, and safety features.

Server Features

get_chat_transcript

Retrieve message history for a specific phone number with optional date filtering. Includes: Message text and timestamps Attachment information (if any) Proper phone number validation Date range filtering

Provider Information

Hannesrudolph logo

Hannesrudolph

cloud Provider

Visit Provider Website

Quick Actions

Visit Website

MCP Configuration

Available Tools

get_chat_transcript