bluebubbles

Send and manage iMessages through BlueBubbles using the generic message tool.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/frankhli843/gemmahermes --skill bluebubbles-frankhli843
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/frankhli843/gemmahermes/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/frankhli843/gemmahermes --skill bluebubbles-frankhli843

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables the AI to send and manage iMessages through BlueBubbles, providing a streamlined channel for conversational messaging.

Core Features & Use Cases

  • Use the generic message tool with channel="bluebubbles" to send texts, attachments, reactions (tapbacks), edits, replies, and group-management actions.
  • Supports contact selection via chat_guid, phone number, or email, and handles attachments via file paths or buffers.
  • Ideal for automating customer updates, team notifications, or personal messaging workflows from an AI assistant.

Quick Start

Send a test message to a contact using the BlueBubbles channel.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I automate sending iMessages through an AI assistant?

You can automate iMessage sending by configuring the BlueBubbles gateway and using the generic message tool with channel="bluebubbles" to send texts, attachments, and reactions directly from your AI assistant.

Can I manage group chats and message reactions using BlueBubbles integration?

Yes, the BlueBubbles integration supports managing group actions, tapback reactions, replies, and edits via the generic message tool configured with channel="bluebubbles" for comprehensive iMessage thread management.

Do I need a BlueBubbles gateway to send iMessages via AI?

Yes, you must configure the BlueBubbles gateway beforehand. The AI assistant uses this gateway connection and the generic message tool with channel="bluebubbles" to execute messaging actions.

What's the best way to send iMessage attachments from an automated workflow?

To send iMessage attachments, use the generic message tool with channel="bluebubbles". It handles attachments via file paths or buffers, allowing you to automate customer updates or team notifications with files.

How do I select contacts when sending iMessages through BlueBubbles?

You can select contacts for iMessage automation by specifying their chat_guid, phone number, or email address when configuring the generic message tool with channel="bluebubbles".

What are the limitations of using BlueBubbles for messaging automation?

BlueBubbles messaging automation requires a pre-configured BlueBubbles gateway and depends on the generic message tool with channel="bluebubbles". All messaging actions are bound to the capabilities of this configured channel.