Skip to main content
Glama
Sign In
imessage-mcp

imessage-mcp

by aryanma
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

imessage-mcp

MCP server for iMessage on macOS. Read and send messages via AI agents.

Requirements

  • macOS

  • Python 3.10+

  • Full Disk Access (for reading messages)

  • Messages.app running (for sending)

Related MCP server: imessage-mcp

Setup

uv sync

Grant Full Disk Access

  1. System Settings → Privacy & Security → Full Disk Access

  2. Add your terminal (Terminal, iTerm, VS Code, Cursor)

  3. Restart the terminal

Run

cd src && python main.py

Server runs at http://127.0.0.1:8080/mcp

Architecture

Layer

Component

Description

Transport

HTTP/MCP

Streamable HTTP via dedalus-mcp

Reads

chat.db

Direct SQL on ~/Library/Messages/chat.db

Sends

osascript

AppleScript RPC to Messages.app

Tools

Tool

Description

check_status

Check if iMessage is ready

read_messages

Read messages (filters: chat_id, search, since, chronological)

list_chats

List conversations

get_chat_participants

Get chat members

get_unread_messages

Get unread messages

get_attachments

Get attachments for a message

download_attachment

Copy attachment to local path

send_imessage

Send text to phone/email

send_to_group

Send text to group chat

send_file

Send file to phone/email

send_file_to_group

Send file to group chat

lookup_contact

Search Contacts.app by name

start_watching

Start watching for new messages

check_new_messages

Get messages since last check

stop_watching

Stop watching

MCP Config

Add to Claude Desktop config:

{
  "mcpServers": {
    "imessage": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • jons-mcp-imessage

      jonmmease
      A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to read iMessage history and send messages on macOS. Supports conversation listing, message search with keyword and semantic modes, contact lookup, and sending messages to existing conversations.
      13
      11
      MIT

    • imessage-mcp

      andrewkriley
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that exposes Apple iMessage as tools for AI assistants, enabling reading, searching, and sending iMessages through natural language.
      -

    • imessage-kit-mcp

      xthezealot
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading, sending, and managing iMessage conversations on macOS through MCP.
      1
      MIT

    • imessage-mcp-server

      tinyxia
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for reading and sending iMessages on macOS. Exposes iMessage history and send capabilities through tools like list_conversations and send_imessage.
      8 npm
      MIT