bluebubbles

Develop and maintain the BlueBubbles external channel plugin for iMessage integration.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/balaraj74/F.R.I.D.A.Y --skill bluebubbles-balaraj74
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/balaraj74/F.R.I.D.A.Y/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/balaraj74/F.R.I.D.A.Y --skill bluebubbles-balaraj74

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the development and maintenance of the BlueBubbles external channel plugin, enabling FRIDAY to interact with iMessage.

Core Features & Use Cases

  • Plugin Development: Facilitates building and updating the BlueBubbles extension package.
  • Channel Implementation: Manages the core logic for iMessage communication via BlueBubbles.
  • Webhook Handling: Processes inbound messages and events from BlueBubbles.
  • REST API Integration: Supports sending messages and performing health checks using BlueBubbles' REST API.
  • Use Case: When a new iMessage arrives via BlueBubbles, this skill ensures FRIDAY can receive, process, and respond to it, maintaining a seamless conversational experience.

Quick Start

Use the bluebubbles skill to send a message to the contact '1234567890'.

Frequently Asked Questions about bluebubbles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate iMessage into my application using the BlueBubbles REST API?

To integrate iMessage using the BlueBubbles REST API, this Skill manages REST API interactions for sending messages and probing endpoints, alongside webhook inbound processing to handle incoming iMessage events seamlessly.

Can I handle iMessage typing indicators and read receipts through a webhook integration?

Yes, webhook integration can handle iMessage typing indicators and read receipts. This Skill processes inbound BlueBubbles webhooks to manage reactions, typing indicators, and read receipts for iMessage conversations.

What is the best way to develop an external channel plugin for iMessage communication?

The best way to develop an external iMessage channel plugin is by managing core communication logic via BlueBubbles. This Skill facilitates building the extension package, handling runtime bridging, and maintaining REST API interactions.

Does the BlueBubbles integration support sending messages and performing health checks?

Yes, the BlueBubbles integration supports sending messages and performing health checks. This Skill utilizes the BlueBubbles REST API to send outbound iMessages and probe endpoints to verify connection health.

How do I process inbound iMessage events from BlueBubbles in my runtime environment?

To process inbound iMessage events from BlueBubbles, this Skill handles webhook inbound processing and runtime bridging, enabling FRIDAY to receive, process, and respond to new iMessage arrivals effectively.