qq418716640/botbell-mcp

BotBell MCP Server
Let AI assistants send push notifications to your iPhone / Mac.
What it does
After setup, your AI assistant (Claude, Cursor, etc.) can:
- **Send you notifications** — task results, alerts, reminders push to your phone
- **Read your replies** — you reply in the BotBell app, AI reads it and continues
- **Manage your bots** — list, create bots (PAT mode only)
Authentication Modes
BotBell MCP Server supports two token types, auto-detected by prefix:
| Token Type | Prefix | Scope | Best For |
|------------|--------|-------|----------|
| **Bot Token** | bt_ | Single bot only | Simple setup, one bot |
| **Personal Access Token (PAT)** | pak_ | All your bots | Multi-bot, full control |
**Bot Token**: Get it from the BotBell app when you create a bot. One token = one bot.
**PAT**: Create one at BotBell app > Settings > API Keys. One token controls all your bots.
Quick Start
1. Install BotBell app
Download from the App Store, create a Bot, and get your token.
2. Install MCP Server
3. Configure Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
**Option A: PAT mode (recommended)**
**Option B: Bot Token mode**
4. Use it
Tell Claude:
- "Send a notification to my phone saying the build is done"
- "Analyze this log file and push the summary to my phone"
- "Check if I have any replies in BotBell"
- "List my bots" (PAT mode)
- "Create a new bot called Deploy Alerts" (PAT mode)
Tools
PAT Mode (pak_ token)
botbell_list_bots
List all your bots. Use this to find the bot_id before sending.
botbell_create_bot
Create a new bot.
| Parameter | Required | Description |
|-----------|----------|-------------|
| name | Yes | Bot name (max 50 chars) |
| description | No | Bot description |
botbell_send
Send a push notification via a specific bot.
| Parameter | Required | Description |
|-----------|----------|-------------|
| bot_id | Yes | Bot ID (use botbell_list_bots to find) |
| message | Yes | Message content (max 4096 chars) |
| title | No | Notification title |
| url | No | URL to attach (tappable) |
| image_url | No | Image URL to attach |
| actions | No | Quick reply buttons (max 5), see Actions |
botbell_get_replies
Check for user replies to a specific bot.
| Parameter | Required | Description |
|-----------|----------|-------------|
| bot_id | Yes | Bot ID to check |
| limit | No | Max replies to fetch (default 20) |
Bot Token Mode (bt_ token)
botbell_send
Send a push notification.
| Parameter | Required | Description |
|-----------|----------|-------------|
| message | Yes | Message content (max 4096 chars) |
| title | No | Notification title |
| url | No | URL to attach (tappable) |
| image_url | No | Image URL to attach |
| actions | No | Quick reply buttons (max 5), see Actions |
botbell_get_replies
Fetch user replies from the BotBell app.
| Parameter | Required | Description |
|-----------|----------|-------------|
| limit | No | Max replies to fetch (default 20) |
Extra Tokens