use-imessages

A skill for AI agents to send iMessages via Blooio with automatic fallback to RCS or SMS when iMessage is unavailable.

What This Does

When you ask an AI agent to send a text message, this skill:

1. Checks capabilities — Determines if the recipient supports iMessage, RCS, or SMS
2. Sends via best channel — Uses iMessage if available, falls back to RCS/SMS otherwise
3. Tracks delivery — Reports which protocol was used and delivery status

Installation

# Via skills CLI
npx skills add blooio/use-imessages

# Or with bunx
bunx add-skill blooio/use-imessages

Prefer MCP?

If you'd rather use an MCP server instead of a skill, Blooio also offers a hosted MCP at mcp.blooio.com.

Usage Examples

Once installed, trigger the skill with prompts like:

• "Send a message to +15551234567 saying 'Hey, running late'"
• "Text John that the meeting is canceled"
• "Check if this number has iMessage"
• "Send 'Hello team!' to my Sales group"
• "Set up a webhook to notify me when I receive messages"

Prerequisites

• Blooio API key — Get one at blooio.com
• Active device — At least one phone with Blooio connected (blooio managed. See app.blooio.com to purchase numbers)

What's Inside

use-imessages/
├── SKILL.md      # Skill definition with API docs and examples
├── AGENTS.md     # Guidance for AI coding agents
├── README.md     # This file
└── LICENSE       # MIT License

API Reference

This skill uses the Blooio API v2. Key endpoints:

Endpoint	Purpose
GET /contacts/{id}/capabilities	Check iMessage/SMS support
POST /chats/{id}/messages	Send a message
GET /chats/{id}/messages/{msgId}/status	Check delivery status
POST /webhooks	Set up real-time notifications

See SKILL.md for complete API documentation and examples.

Related Resources

• Sign up for Blooio and get a phone number. Free trial no credit card needed
• Blooio Documentation
• Agent Skills Specification
• Claude Custom Skills Guide

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Please ensure any API changes are reflected in SKILL.md.

License

MIT — see LICENSE for details.