BlueBubbles iMessage Skill#

Overview#

Use this skill to send and manage iMessage conversations through a self-hosted BlueBubbles server. Supports text messages, attachments, reactions, edits, unsend, and iMessage effects.

Configuration#

Add this to your gateway config:

toml

[channels.bluebubbles]
server_url = "http://192.168.1.100:1234"  # Your BlueBubbles server URL
password = "your-server-password"
allowed_senders = ["*"]  # Allow all senders, or list specific handles

Usage Examples#

Send a text message#

json

{
  "tool": "bluebubbles_send",
  "parameters": {
    "target": "+15551234567",
    "message": "Hello from your AI assistant!"
  }
}

Send a message with iMessage effect#

json

{
  "tool": "bluebubbles_send",
  "parameters": {
    "target": "+15551234567",
    "message": "Congratulations! 🎉",
    "effect": "confetti"
  }
}

Send an attachment#

json

{
  "tool": "bluebubbles_send_attachment",
  "parameters": {
    "target": "+15551234567",
    "file_path": "/workspace/output/report.pdf",
    "caption": "Here's the report you requested"
  }
}

React to a message#

json

{
  "tool": "bluebubbles_react",
  "parameters": {
    "target": "+15551234567",
    "message_id": "msg_12345",
    "emoji": "👍"
  }
}

Supported Effects#

• slam, loud, gentle, invisible-ink
• balloons, confetti, lasers, fireworks, shooting-star
• celebration, echo, spotlight, love