drio
Open app

iMessage Query MCP Server

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

The iMessage Query MCP Server is a server that provides safe access to your iMessage database through the Model Context Protocol (MCP). It allows large language models (LLMs) to query and analyze iMessage conversations with proper phone number validation and attachment handling.

To use the server, clone the repository from GitHub, install the required dependencies, and choose an installation option for either Claude Desktop or the Cline VSCode plugin.

  • Safe read-only access to the iMessage database. - Phone number validation using the phonenumbers library. - Retrieval of message history with optional date filtering. - Support for attachment handling and missing file detection.
  1. Analyzing iMessage conversations for sentiment analysis.
  2. Retrieving chat transcripts for specific phone numbers.
  3. Integrating iMessage data with other applications for enhanced functionality.

Add to your AI client

Use these steps to connect iMessage Query MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hannesrudolph-imessage-query-fastmcp-mcp-server-mcp-mirror"
      ]
    }
  }
}

FAQ

**Is the server safe to use?**

Yes! The server provides read-only access to the iMessage database and includes safety features for validation and error handling.

**What are the system requirements?**

The server requires macOS and Python 3.6 or higher.

**Can I use this server with other applications?**

Yes! The server can be integrated with various applications that support the Model Context Protocol.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":645,"uuid":"c1d07d0a-3916-4691-bb8d-fbc8a46148da","name":"hannesrudolph_imessage-query-fastmcp-mcp-server","title":"iMessage Query MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:25:04.195Z","updated_at":"2025-02-23T07:15:12.969Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"imessage,mcp-server,llm-query","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/hannesrudolph_imessage-query-fastmcp-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools