Skip to main content
Glama
photon-hq

Photon MCP iMessage

Official
by photon-hq

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

/imessage

3001

Setup

pnpm install
pnpm dev

Run a single service:

pnpm dev:imessage
pnpm dev:gateway

Build & Deploy

pnpm build
docker compose up -d

Structure

gateway/              reverse proxy
services/
  imessage/           iMessage MCP (67 tools)

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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 npm
    10
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables 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.
    33
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables reading and sending iMessages on macOS through MCP, with tools for managing chats, messages, and attachments via AI agents.
    MIT