Skip to content
MCP server

Blujay

Let Claude, Cursor or VS Code read and send iMessage, RCS and SMS from Blujay numbers

Runs locallyActively maintainedStatus and history

The repository was last updated 6 days ago and is published under MIT.

Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
GitHub stars
0
Last commit
6 days ago
Language
TypeScript

About Blujay

Blujay is a freemium MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • BLUJAY_API_KEYYour Blujay API key, from API in the Blujay sidebar.Required

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Server is MIT licensed; needs a Blujay account with a Free plan, paid plan prices not published

Prices change. Check docs.blujay.io before you buy.

Blujay 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 to Blujay

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity