hannesrudolph/imessage-query-fastmcp-mcp-server

Overview

An MCP server that enables LLMs to query and analyze iMessage conversations through the Model Context Protocol. Built with the FastMCP framework and the imessagedb library, it provides safe database access with phone number validation and attachment handling.

Best for

Best for
Developers building LLM tools that need to access and analyze iMessage data on macOS

Use cases

• Query iMessage history from within an LLM-powered assistant
• Analyze conversation patterns or extract specific messages
• Integrate iMessage data into AI workflows or automation tools

How to use

Install

pip install -r requirements.txt

Tools exposed

• get_chat_transcript

Tested with

Claude Desktop, Cline

Example client config

{\n  "imessage-query": {\n    "command": "uv",\n    "args": [\n      "run",\n      "--with",\n      "fastmcp",\n      "fastmcp",\n      "run",\n      "/path/to/repo/imessage-query-server.py"\n    ]\n  }\n}

Notes

An MCP server that enables LLMs to query and analyze iMessage conversations through the Model Context Protocol. Built with the FastMCP framework and the imessagedb library, it provides safe database access with phone number validation and attachment handling.

78 stars on GitHub. Last updated 2026-02-03.

Use cases

• Query iMessage history from within an LLM-powered assistant
• Analyze conversation patterns or extract specific messages
• Integrate iMessage data into AI workflows or automation tools

Pros

• Provides safe, validated access to the iMessage database
• Handles phone number validation and attachments properly
• Built on FastMCP for easy integration with MCP-compatible LLMs

Cons

• Limited to macOS iMessage databases only
• Requires local setup and configuration of the MCP server
• Small community (78 stars) may mean slower updates or support

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.