imessage-query-fastmcp-mcp-server

Overview

This MCP server enables LLMs to query and analyze iMessage conversations on macOS through the FastMCP framework. It provides read-only access to the iMessage database with safety features including phone number validation, attachment handling, and date filtering. The server is well-documented with multiple installation options and includes development documentation.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_chat_transcript

  Retrieve message history for a specific phone number with optional date filtering.

  Try:Show me the transcript for conversations with 555-123-4567Try:Get messages from my mom between January and March 2023Try:Retrieve all iMessage conversations with attachments

Comparable tools

Installation

pip install -r requirements.txt

fastmcp install imessage-query-server.py --name "iMessage Query"

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

FAQ

Can this server access iMessage on Windows or Linux?

No, this server requires macOS as it directly accesses the iMessage database which is only available on Apple's operating system.

Is the server read-only?

Yes, the server provides read-only access to the iMessage database with no ability to modify or delete messages.

Compare imessage-query-fastmcp-mcp-server with