# Blujay

> Blujay is a freemium MCP server for communication. Let Claude, Cursor or VS Code read and send iMessage, RCS and SMS from Blujay numbers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://docs.blujay.io/mcp-server
- **Repository:** https://github.com/blujayhq/blujay-mcp
- **GitHub stars:** 0
- **License:** MIT
- **MCP Registry name:** io.github.blujayhq/blujay-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

Every text sent through this server is real, since Blujay has no test mode. To make that safe, the server offers an allow-list flag that limits sends to numbers you name, a read-only flag that removes every tool that sends or changes anything, and an opt-in raw API tool that stays read-only when combined with either.

Other guards include holding a repeat of the same text to the same person within 10 minutes for confirmation, telling the assistant never to follow instructions found inside a message, and sending only files you name by full path. Attachments can be photos, videos, contact cards, PDFs and audio up to 100 MiB, and iMessage effects work in existing chats.

It runs locally over stdio through npx and needs Node.js 20 and a Blujay API key. What you can do depends on your plan: the Free plan uses a shared number and up to 10 verified contacts.

## Features

- **Read conversations:** List chats, pull a transcript or find conversations waiting on your reply.
- **Send rich messages:** Text people or groups with files, voice memos and iMessage effects.
- **Edit and unsend:** React, edit or unsend an iMessage.
- **Safe-send flags:** Restrict sends to listed numbers or switch to read-only.
- **Delivery checks:** See delivery status and failure reasons, and test whether a number uses iMessage.
- **Contacts and webhooks:** Save contacts, opt people out and create webhooks.

## Good for

- Ask who is waiting on a reply
- Summarise a conversation and draft an answer
- Send a PDF to a client by text
- Check whether a message was delivered
- Rehearse sends against your own number first

## Install

### Claude Code (Terminal)

```sh
claude mcp add blujay-mcp --env BLUJAY_API_KEY='<BLUJAY_API_KEY>' -- npx -y blujay-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "blujay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "blujay-mcp"
      ],
      "env": {
        "BLUJAY_API_KEY": "<BLUJAY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "blujay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "blujay-mcp"
      ],
      "env": {
        "BLUJAY_API_KEY": "<BLUJAY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "blujay-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "blujay-mcp"
      ],
      "env": {
        "BLUJAY_API_KEY": "<BLUJAY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "blujay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "blujay-mcp"
      ],
      "env": {
        "BLUJAY_API_KEY": "<BLUJAY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "blujay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "blujay-mcp"
      ],
      "env": {
        "BLUJAY_API_KEY": "<BLUJAY_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_account`: Workspace, numbers and what each can do.
- `list_conversations`: Recent conversations.
- `get_conversation`: One conversation as a transcript.
- `find_unanswered`: Conversations waiting on your reply.
- `get_message`: Delivery status and failure reason of a message.
- `check_imessage`: Whether a number uses iMessage.
- `find_contacts`: List or search contacts.
- `list_webhooks`: Webhooks and recent deliveries.
- `search_docs`: Search the Blujay docs.
- `send_message`: Text a person or group with optional file, voice memo or effect.
- `react_to_message`: Add or remove a tapback.
- `edit_message`: Edit a sent iMessage.
- `unsend_message`: Unsend an iMessage.
- `mark_conversation_read`: Mark a conversation as read.
- `set_typing`: Show or hide the typing indicator.
- `update_group`: Rename a group or change its members.
- `save_contact`: Create or update a contact.
- `opt_out_contact`: Stop all texts to a contact.
- `create_webhook`: Create a webhook subscription.
- `invoke_api`: Call any Blujay endpoint, enabled only by a flag.

## FAQ

### Is there a test mode?

No, every text is real, so try it with the allow-list flag set to your own number.

### What do I need?

Node.js 20 or later and a Blujay API key from the API page.

### Can I stop it sending?

Yes, the read-only option leaves out every tool that sends or changes anything.

### Which plans can message whom?

Free allows up to 10 verified contacts on a shared number, Dedicated can message anyone who has not opted out, and AI Agent numbers reply to people who text first.

### Is Blujay free?

Blujay has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add blujay-mcp --env BLUJAY_API_KEY='<BLUJAY_API_KEY>' -- npx -y blujay-mcp

### What are the best alternatives to Blujay?

The closest alternatives to Blujay are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/blujay
