Last updated
March 16, 2026
MCP profile
Github Cyberpapiii Imessage Max
AI-optimized MCP server for iMessage on macOS. Read, search, and send messages.
Developer ToolsPackagePythonOpen SourceExternal
Visibility
Public
ByRegistry
About This MCP Server
A high-performance MCP (Model Context Protocol) server for iMessage that lets AI assistants read, search, and send your messages with proper contact resolution.
Built in Swift for native macOS integration - single binary, no runtime dependencies.
Capabilities
12 Intent-Aligned Tools - Work the way you naturally ask questions, not raw database queriesContact Resolution - See names instead of phone numbers via macOS ContactsSmart Image Handling - Efficient image variants (vision/thumb/full) to avoid token bloatSession Grouping - Messages grouped into conversation sessions with gap detectionAttachment Tracking - Know which images are available locally vs offloaded to iCloudNative Performance - Swift with raw SQLite3, Core Image GPU accelerationRead-Only Safe - Only reads from chat.db, send requires explicit permission
Why Use Github Cyberpapiii Imessage Max?
- 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
- Read-Only Safe - Only reads from chat.db, send requires explicit permission
Specifications
Status
live
Industry
Developer Tools
Category
General
Server type
Package
Language
Python
License
Open Source
Verified
Yes
Requirements
- macOS 13+ (Ventura or later)
- Full Disk Access permission
- Contacts permission (for name resolution)
- Automation permission for Messages.app (send only)
Hosting
Hosting Options
- Package
API
Integrate this server into your application. Choose a connection method below.
1
Install
Install command
Python
brew install imessage-max2
Configure
Configuration
json
{
"mcpServers": {
"imessage": {
"command": "/opt/homebrew/Cellar/imessage-max/1.0.0/bin/imessage-max"
}
}
}Performance
Usage
Quick Reference
- Name
- Github Cyberpapiii Imessage Max
- Function
- AI-optimized MCP server for iMessage on macOS. Read, search, and send messages.
- Transport
- Package
- Language
- Python
- Install
- brew install imessage-max
- Source
- External (Registry)
- License
- Open Source
Get started
Ready to integrate this MCP server?
Book a demo to see how this server fits your workflow, or explore the full catalog.