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
Send and read iMessages from your own Mac and Apple ID — drafts, history and contacts.
1Explore 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
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.246 npm10MIT
- AlicenseAqualityDmaintenanceEnables 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.332MIT
- AlicenseNot gradedqualityDmaintenanceEnables reading and sending iMessages on macOS through MCP, with tools for managing chats, messages, and attachments via AI agents.MIT
- AlicenseNot gradedqualityDmaintenanceEnables reading, sending, and managing iMessage conversations on macOS through MCP.1MIT