Photon MCP iMessage
OfficialProvides tools for iMessage chats, messages, attachments, contacts, polls, scheduled messages, FaceTime, Find My, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Photon MCP iMessagesend a message to Mom saying I love you"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Photon MCP
MCP servers for Photon, deployed at mcp.photon.codes.
Usage
iMessage
Exposes 67 MCP tools for iMessage — chats, messages, attachments, contacts, polls, scheduled messages, FaceTime, Find My, and more. Built on @photon-ai/advanced-imessage-kit. Each client authenticates via x-server-url and x-api-key headers.
{
"mcpServers": {
"photon-imessage": {
"url": "https://mcp.photon.codes/imessage",
"headers": {
"x-server-url": "https://your-endpoint-here",
"x-api-key": "your-api-key-here"
}
}
}
}Related MCP server: bluebubbles-mcp
Services
Service | Endpoint | Port |
Gateway |
| 3000 |
iMessage |
| 3001 |
Setup
pnpm install
pnpm devRun a single service:
pnpm dev:imessage
pnpm dev:gatewayBuild & Deploy
pnpm build
docker compose up -dStructure
gateway/ reverse proxy
services/
imessage/ iMessage MCP (67 tools)This server cannot be deployed
Maintenance
Related MCP Connectors
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Explore your Messages SQLite database to browse tables and inspect schemas with ease. Run flexible…
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading, searching, and sending iMessages directly from MCP-compatible clients by accessing the local macOS iMessage database, supporting conversations, attachments, and both individual and group chats.258 npm10MIT
- AlicenseAqualityCmaintenanceEnables interaction with iMessage through a BlueBubbles server, allowing users to read, search, and send messages directly from MCP clients. It supports comprehensive chat management features including reactions, group chat moderation, message scheduling, and contact lookups.331MIT
- AlicenseNot gradedqualityDmaintenanceEnables sending and reading iMessages and SMS messages through the macOS Messages app via MCP.MIT
- AlicenseNot gradedqualityDmaintenanceEnables reading and sending iMessages on macOS through MCP, with tools for managing chats, messages, and attachments via AI agents.MIT