BlueBubbles Plugin

iMessage connector via a local BlueBubbles server.

Package: @elizaos/plugin-bluebubbles

Auto-Enable

This plugin auto-enables when both serverUrl and password are set in the connector config. No manual install is required.

Auto-Enable

This plugin auto-enables when the BLUEBUBBLES_SERVER_URL environment variable is set.

Configuration

Variable	Required	Description
BLUEBUBBLES_SERVER_URL	Yes	BlueBubbles server URL
BLUEBUBBLES_PASSWORD	Yes	Server password
BLUEBUBBLES_ENABLED	No	Enable or disable the connector
BLUEBUBBLES_DM_POLICY	No	DM policy (e.g., allow, deny, allowlist)
BLUEBUBBLES_ALLOW_FROM	No	Comma-separated allowed user list
BLUEBUBBLES_GROUP_POLICY	No	Group message policy
BLUEBUBBLES_WEBHOOK_PATH	No	Webhook endpoint path
BLUEBUBBLES_GROUP_ALLOW_FROM	No	Comma-separated allowed group list
BLUEBUBBLES_SEND_READ_RECEIPTS	No	Send read receipts for received messages

Features

• Send and receive iMessage via BlueBubbles HTTP API
• DM and group chat support
• Read receipts
• Webhook-based inbound messages
• Network-accessible (not limited to the Mac running Messages)

Related

• BlueBubbles Connector Setup — Full configuration reference
• iMessage Plugin — Native iMessage connector
• Blooio Plugin — iMessage/SMS via Blooio cloud