Skip to main content
Glama
aryanma

imessage-mcp

by aryanma
OverviewSchemaRelated ServersScoreDiscussions
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: jons-mcp-imessage

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"
    }
  }
}

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • messages-bridge

    MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay

  • local-mcp

    Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.

  • notesbridge

    Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aryanma/imessage-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server