Skip to main content
Glama
viraatdas

iMessage MCP Server

by viraatdas

imessage-mcp

MCP server that exposes iMessage read/send capabilities on macOS. Runs on a Mac with Messages.app and can be accessed remotely via SSH over Tailscale.

Tools

Tool

Description

list_conversations

List recent conversations with last message preview

get_messages

Get messages from a specific conversation

search_messages

Full-text search across all messages

get_contact_info

Look up contact stats by phone/email

send_message

Send an iMessage to a phone number or email

send_group_message

Send a message to a named group chat

Related MCP server: iMessage MCP Server

Setup (local)

uv run imessage-mcp

Requires macOS with Messages.app and Full Disk Access for the terminal process.

Claude Code config (local)

{
  "mcpServers": {
    "imessage": {
      "command": "uv",
      "args": ["--directory", "/path/to/imessage-mcp", "run", "imessage-mcp"]
    }
  }
}

Claude Code config (remote via SSH)

From any device on the Tailscale network:

{
  "mcpServers": {
    "imessage": {
      "command": "ssh",
      "args": [
        "mba-server",
        "/Users/viraat/.local/bin/uv --directory /Users/viraat/Documents/imessage-mcp run imessage-mcp"
      ]
    }
  }
}

This pipes MCP stdio through SSH — the server runs on the Mac, reads chat.db, and sends via AppleScript.

Install Server
F
license - not found
A
quality
D
maintenance

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

  • A
    license
    -
    quality
    C
    maintenance
    Enables Claude to send and read iMessages on macOS, with smart contact lookup, message history retrieval, and cross-conversation search using natural language commands.
    Last updated
    5
    MIT
  • 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.
    Last updated
    13
    11
    MIT
  • A
    license
    -
    quality
    C
    maintenance
    Enables AI assistants to read, search, and send iMessages with features like contact name resolution, session grouping, and attachment listing. It provides intent-aligned tools to efficiently navigate conversation history and manage messages through natural language queries.
    Last updated
    5
    MIT

View all related MCP servers

Related MCP Connectors

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

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

  • 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/viraatdas/imessage-mcp'

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