Back to MCP Directory
Imessage Query Fastmcp
Model Context Protocol low risk

Imessage Query Fastmcp

This MCP server provides read-only access to iMessage data, enabling LLMs to query and analyze message history with phone number validation and attachment handling.

Connections & Capabilities

Connects To

GitHub

Capabilities

read

Quickstart

Install

brew install uv

Config

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

Exposed MCP Tools (1)

safe
get_chat_transcript

Retrieves message history for a specific phone number, optionally filtered by date.

Read-only access to message data with phone number validation.

Safety Assessment

This server is relatively safe due to its read-only nature and input validation. However, users should be aware of the potential for exposing sensitive information and ensure responsible use.

  • Read-only access to the iMessage database
  • Phone number validation using the phonenumbers library
  • Safe attachment handling with missing file detection
  • Date range validation
  • Potential for sensitive data exposure if not used responsibly
  • Reliance on macOS security for database access
  • No built-in rate limiting to prevent abuse
  • Requires local file system access for database