mcpserver.so LogoMCPFly
Submit
iMessage Query MCP Server logo

iMessage Query MCP Server

by hannesrudolph

AI/Development ToolsiMessageFastMCPDatabase Query

This MCP server provides safe access to your iMessage database through Model Context Protocol (MCP). It enables LLMs to query and analyze iMessage conversations with proper phone number validation and attachment handling.

View on GitHub

Last updated: N/A

What is iMessage Query MCP Server?

An MCP server built with the FastMCP framework that allows LLMs to query and analyze your iMessage database safely. It uses the imessagedb library for database access and provides phone number validation and attachment handling.

How to use iMessage Query MCP Server?

  1. Clone the repository. 2. Install dependencies using pip install -r requirements.txt. 3. Choose an installation option: Claude Desktop (using fastmcp install) or Cline VSCode plugin (by adding a configuration entry). 4. Configure the chosen option with the correct path to the server script.

Key features of iMessage Query MCP Server

  • Safe iMessage database access

  • Phone number validation

  • Attachment handling

  • Date range filtering

  • Read-only access

Use cases of iMessage Query MCP Server

  • Analyzing iMessage conversations with LLMs

  • Retrieving message history for a specific phone number

  • Extracting information from iMessage attachments

  • Summarizing iMessage conversations

  • Building LLM-powered iMessage tools

FAQ from iMessage Query MCP Server

What operating system is required?

macOS is required for iMessage database access.

What is FastMCP?

FastMCP is a framework for building Model Context Protocol servers.

What is imessagedb?

imessagedb is a Python library for accessing and querying the macOS Messages database.

Are there any environment variables required?

No, the server automatically locates the iMessage database in the default macOS location.

Where can I find documentation about the iMessage database?

The repository includes a dev_docs/imessagedb-documentation.txt file with comprehensive documentation about the iMessage database structure.