mcp-registry/imessage-query-fastmcp-mcp-server

    ==================
      
       /// MCP ///
      /// IME ///
        
    ==================
        
    [server:online]
    [protocol:ready]

imessage-query-fastmcp-mcp-server

by hannesrudolph

An MCP server that exposes read-only, validated access to the macOS iMessage (chat.db) database via FastMCP so LLMs can query chat transcripts safely.

63
9
Specialized
GitHubDocumentation

01

get_chat_transcript

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

Installation

1. Clone the repository
git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git cd imessage-query-fastmcp-mcp-server
2. Create and activate a virtual environment (recommended)
python3 -m venv .venv source .venv/bin/activate
3. Install Python dependencies
pip install -r requirements.txt
or, if a Poetry lock-file is present:
poetry install
4. Configure environment variables (minimum)
# Absolute path to your local iMessage SQLite database export IMESSAGE_DB_PATH="$HOME/Library/Messages/chat.db" # Optional: port on which to run the FastMCP server export MCP_SERVER_PORT=8000
You can alternatively copy `.env.example` to `.env` and edit the values.
5. Start the server
uvicorn mcp_server.app:app --host 0.0.0.0 --port ${MCP_SERVER_PORT:-8000}
On first launch the server will validate the database location, build indexes and expose the MCP endpoints under `/mcp/`.
6. Verify
curl http://localhost:8000/health
A JSON `{ "status": "ok" }` confirms the service is up.

Documentation

License: No license specified (no LICENSE file detected)
Updated 7/30/2025