imessage-query-fastmcp-mcp-server

51
communication

The iMessage Query MCP Server is an MCP server designed to offer secure access to the iMessage database on macOS systems. It enables querying and analysis of iMessage conversations using the FastMCP framework while ensuring data safety with proper validation features.

iMessage Query MCP Server

An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP). This server utilizes the FastMCP framework and the imessagedb library to enable LLMs to query iMessage conversations safely. Key features include phone number validation, attachment handling, and date range filtering.

System Requirements

  • macOS for iMessage database access
  • Python 3.6+

Dependencies

  • fastmcp for building MCP servers
  • imessagedb for accessing the macOS Messages database
  • phonenumbers for phone number validation

MCP Tools

  • get_chat_transcript: Retrieve message history, including message text, timestamps, attachments, with phone number and date validation.

Safety Features

  • Read-only database access
  • Phone number and attachment validation
  • Clean JSON responses