Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Vertex AI MCP Server
  • SQL Query MCP Server
  • MCP Server for Intercom
  • GHAS MCP server GitHub Advanced Security
  • CloudWatch Logs MCP Server
Back to MCP Servers
imessage-query-fastmcp-mcp-server

imessage-query-fastmcp-mcp-server

Public
hannesrudolph/imessage-query-fastmcp-mcp-server

Provides secure, read-only access to macOS iMessage databases via Model Context Protocol, enabling LLMs to query conversations with phone number validation, attachment handling, and date filtering for advanced message analysis.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with imessage-query-fastmcp-mcp-server

MCP Server

Unlock the full potential of imessage-query-fastmcp-mcp-server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

iMessage Query MCP Server

An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP). This server is built with the FastMCP framework and the imessagedb library, enabling LLMs to query and analyze iMessage conversations with proper phone number validation and attachment handling.

📋 System Requirements

  • macOS (required for iMessage database access)
  • Python 3.6+

📦 Dependencies

Install all required dependencies:

# Using pip pip install -r requirements.txt

Required Packages

  • fastmcp: Framework for building Model Context Protocol servers
  • imessagedb: Python library for accessing and querying the macOS Messages database
  • phonenumbers: Google's phone number handling library for proper number validation and formatting

All dependencies are specified in requirements.txt for easy installation.

📑 Table of Contents

  • System Requirements
  • Dependencies
  • MCP Tools
  • Getting Started
  • Installation Options
    • Claude Desktop
    • Cline VSCode Plugin
  • Safety Features
  • Development Documentation
  • Environment Variables

🛠️ MCP Tools

The server exposes the following tools to LLMs:

get_chat_transcript

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

  • Message text and timestamps
  • Attachment information (if any)
  • Proper phone number validation
  • Date range filtering

🚀 Getting Started

Clone the repository:

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git cd imessage-query-fastmcp-mcp-server

📦 Installation Options

You can install this MCP server in either Claude Desktop or the Cline VSCode plugin. Choose the option that best suits your needs.

Option 1: Install for Claude Desktop

Install using FastMCP:

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

Option 2: Install for Cline VSCode Plugin

To use this server with the Cline VSCode plugin:

  1. In VSCode, click the server icon (☰) in the Cline plugin sidebar
  2. Click the "Edit MCP Settings" button (✎)
  3. Add the following configuration to the settings file:
{ "imessage-query": { "command": "uv", "args": [ "run", "--with", "fastmcp", "fastmcp", "run", "/path/to/repo/imessage-query-server.py" ] } }

Replace /path/to/repo with the full path to where you cloned this repository (e.g., /Users/username/Projects/imessage-query-fastmcp-mcp-server)

🔒 Safety Features

  • Read-only access to the iMessage database
  • Phone number validation using the phonenumbers library
  • Safe attachment handling with missing file detection
  • Date range validation
  • Progress output suppression for clean JSON responses

📚 Development Documentation

The repository includes documentation files for development:

  • dev_docs/imessagedb-documentation.txt: Contains comprehensive documentation about the iMessage database structure and the imessagedb library's capabilities.

This documentation serves as context when developing features and can be used with LLMs to assist in development.

⚙️ Environment Variables

No environment variables are required as the server automatically locates the iMessage database in the default macOS location.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Vertex AI MCP Server
    Vertex AI MCP Server

    Provides a Model Context Protocol server enabling advanced interaction with Google Cloud's Vertex AI...

    20 tools
    Added May 30, 2025
  • SQL Query MCP Server
    SQL Query MCP Server

    Enables natural language querying of PostgreSQL databases by translating prompts into SQL via LLM in...

    Added May 30, 2025
  • MCP Server for Intercom
    MCP Server for Intercom

    Enables AI assistants to access, search, and filter Intercom customer support conversations and tick...

    4 tools
    Added May 30, 2025
  • GHAS MCP server GitHub Advanced Security
    GHAS MCP server GitHub Advanced Security

    Provides Model Context Protocol (MCP) integration for GitHub Advanced Security by enabling read-only...

    Added May 30, 2025
  • CloudWatch Logs MCP Server
    CloudWatch Logs MCP Server

    Provides Model Context Protocol (MCP) tools to access AWS CloudWatch logs, enabling AI assistants to...

    Added May 30, 2025