SSyncDev

Imessage MCP Server

AI-optimized MCP server for iMessage on macOS. Read, search, and send messages.

Local serverstdioPython

What is the Imessage MCP Server?

AI-optimized MCP server for iMessage on macOS. Read, search, and send messages.

What you get

A high-performance MCP (Model Context Protocol) server for iMessage that lets AI agents read, search, and send your messages with proper contact resolution.

  • 12 Intent-Aligned Tools — - Work the way you naturally ask questions, not raw database queries
  • Contact Resolution — - See names instead of phone numbers via macOS Contacts
  • Smart Image Handling — - Efficient image variants (vision/thumb/full) to avoid token bloat
  • Session Grouping — - Messages grouped into conversation sessions with gap detection
  • Attachment Tracking — - Know which images are available locally vs offloaded to iCloud
  • Native Performance — - Swift with raw SQLite3, Core Image GPU acceleration

Configuration and credentials

  • macOS 13+ (Ventura or later) - Full Disk Access permission - Contacts permission (for name resolution) - Automation permission for Messages.app (send only)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
find_chat
get_chat_detailsInspect a known thread without opening the full conversation.
get_messagesRetrieve messages with flexible filtering. Returns metadata for media.
get_attachmentRetrieve image content by attachment ID with resolution variants.
list_chats
search
get_context
get_active_conversations
list_attachmentsBrowse shared items grouped by message. Each row includes exact attachment ids for follow-up fetches.
get_unreadGet unread threads or unread messages. Default is summary by chat.
sendSend a message or file attachment (requires Automation permission for Messages.app).
diagnose

Configuration

  • macOS 13+ (Ventura or later) - Full Disk Access permission - Contacts permission (for name resolution) - Automation permission for Messages.app (send only)

Example prompts to try

  • “Use Imessage to find chat.”
  • “Use Imessage to get chat details.”
  • “Use Imessage to get messages.”

Frequently asked questions

AI-optimized MCP server for iMessage on macOS. Read, search, and send messages. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Imessage MCP Server

PostgreSQL

Inspect PostgreSQL schemas and run read-only queries with the archived MCP reference server. Review its maintenance status before choosing it.

DatabasesTypeScript★ 63.0k

Notion

Official

Connect the Notion MCP server to search workspace content and work with pages and databases through Notion’s hosted OAuth service.

Productivity & Project ManagementRemoteTypeScript★ 3.3k

Supabase

Official

Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.

DatabasesRemoteTypeScript★ 2.2k

SQLite

Official

Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.

DatabasesPython★ 63.0k

Metabase

Official

Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.

DatabasesRemoteClojure★ 48.5k

MongoDB

Official

Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.

DatabasesTypeScript★ 900