Official description7 sourcesMCP servers8d ago
qq418716640/botbell-mcp
Send push notifications to i
View on GitHub ↗Direct link · no redirect page
Config template (adjust for your client)
claude mcp add botbell-mcp -- npx -y botbell-mcp
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 1 ★ · qq418716640/botbell-mcp · read from the GitHub search API · (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
- Score
- score 703 · 1 ★ · 7 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
qq418716640/botbell-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.Third-party quality signals
English | 中文
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
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
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
- Source
- awesome · https://github.com/qq418716640/botbell-mcp
- Browse by field
- MCP servers
- Traction
- 1 ★
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.