# Photon

> Photon is an MCP server for communication. MCP server giving AI agents access to Photon's messaging lines across iMessage, WhatsApp. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI, self-hosted, Web
- **Website:** https://photon.codes/docs/beta/ai-tools/mcp
- **Repository:** https://github.com/photon-hq/mcp-server/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.photon-hq/mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication), [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-18

## About

The Photon MCP server lets an AI client manage messaging infrastructure on a Photon account. Through it, an agent can create projects, attach phone numbers to shared iMessage lines, and query message volume or billing usage for an organization. It is offered both as a hosted remote endpoint that connects over OAuth and as a local npm package that runs over stdio with an account service key.

The README describes the local package as offering the same tools as the hosted server, minus operations for managing keys, account security, SSO or billing checkout. Its Apache 2.0 licence is listed in the repository. The docs recommend keeping client approval enabled for tools that send messages, buy numbers or lines, or change and delete resources.

The server suits developers who want an agent to handle messaging setup and reporting for Photon-hosted channels. Because message contents and webhook payloads come from third parties, the docs also warn about prompt injection when agents read incoming messages.

## Features

- **Hosted remote endpoint:** Connects to a streamable HTTP server at mcp.photon.codes with OAuth in supported clients.
- **Local stdio package:** Runs as the @photon-ai/mcp npm package using a Photon account service key for clients that only support stdio.
- **Project and line management:** Lets agents create projects and add phone numbers to shared iMessage lines.
- **Messaging usage reports:** Answers questions about how many messages a project sent or received and shows billing usage.
- **Approval-based safety guidance:** Documentation advises keeping client confirmation on for sending, purchasing and destructive actions.

## Good for

- Create a project and attach a shared iMessage line from an AI assistant
- Check weekly message volume for a Photon project without opening the dashboard
- Review an organization's current billing usage through a chat client
- Let a coding agent set up Photon messaging resources during development

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.photon.codes/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.photon.codes/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.photon.codes/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.photon.codes/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.photon.codes/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.photon.codes/mcp
```

Enter a Name (for example "Photon"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.photon.codes/mcp"
    }
  }
}
```

## FAQ

### Do I need an API key to use the hosted server?

No. The README says the hosted server at https://mcp.photon.codes/mcp needs no key and works with clients that support remote MCP servers with OAuth.

### What is the local version for?

The README says it is for clients that only run stdio servers. It requires a PHOTON_API_KEY account service key and Node.js 22 or newer.

### Which messaging channels does it cover?

The registry entry describes messaging across iMessage, WhatsApp, Telegram and SMS.

### Can the server manage API keys or billing checkout?

No. The README states that key management, account security, SSO and billing checkout are not available in the local server.

### How do I add Photon to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.photon.codes/mcp

### What are the best alternatives to Photon?

The closest alternatives to Photon are imsg-mcp, MCP Telegram Bot, ChatPush: WhatsApp, Telegram, MAX & SMS, Callsign and Selfping.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [imsg-mcp](https://ai-powered.com/mcp/imsg-mcp): imsg-mcp is an open-source MCP server for communication.
- [MCP Telegram Bot](https://ai-powered.com/mcp/mcp-telegram-bot): MCP Telegram Bot is an open-source MCP server for communication.
- [ChatPush: WhatsApp, Telegram, MAX & SMS](https://ai-powered.com/mcp/chatpush-whatsapp-telegram-max-and-sms): ChatPush: WhatsApp, Telegram, MAX & SMS is a freemium MCP server for communication.
- [Callsign](https://ai-powered.com/mcp/callsign): Callsign is an open-source MCP server for communication.
- [Selfping](https://ai-powered.com/mcp/selfping): Selfping is a freemium MCP server for communication.
- [Sempera](https://ai-powered.com/mcp/sempera): Sempera is an open-source MCP server for communication.
- [SendPanda](https://ai-powered.com/mcp/sendpanda-2): SendPanda is a freemium MCP server for communication.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mwenf0i2): MCP Server is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/photon-2
