Blujay
Let Claude, Cursor or VS Code read and send iMessage, RCS and SMS from Blujay numbers
The repository was last updated 6 days ago and is published under MIT.
- 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-mcpAdd 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

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity