convez.ai
MCP ServerIntegração & APIsIntermediário
qq418716640

BotBell MCP Server

qq418716640/botbell-mcp

Dê voz ao seu IA com notificações push e comunicação bidirecional

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite aos agentes de IA enviar notificações push para iPhone e Mac, ler respostas do usuário e gerenciar múltiplos bots. Funciona com Claude, Cursor e outros assistentes, oferecendo duas camadas de autenticação para diferentes casos de uso.

Instalação

$npx convez-ai qq418716640/botbell-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 8 meses
Versão
v0.2.3
Issues abertas
0
Contribuidores
1

Casos de uso

  • Enviar alertas e resultados de tarefas do IA para o celular em tempo real
  • Criar fluxos interativos onde o IA lê respostas do usuário via app
  • Gerenciar múltiplos bots de notificação com um único token (PAT)

Veredito

MCP server bem estruturado para integrar notificações push em workflows com IA. Suporta tanto setup simples (um bot) quanto avançado (multi-bot com PAT), com documentação clara e dois modos de autenticação sensatos.

README

A tradução para o português deste README ainda está na fila.

English | 中文

BotBell MCP Server

MCP Badge Glama

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 TypePrefixScopeBest For
Bot Tokenbt_Single bot onlySimple setup, one bot
Personal Access Token (PAT)pak_All your botsMulti-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

npm install -g @botbell/mcp-server

3. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

Option A: PAT mode (recommended)

{
  "mcpServers": {
    "botbell": {
      "command": "botbell-mcp",
      "env": {
        "BOTBELL_TOKEN": "pak_your_pat_here"
      }
    }
  }
}

Option B: Bot Token mode

{
  "mcpServers": {
    "botbell": {
      "command": "botbell-mcp",
      "env": {
        "BOTBELL_TOKEN": "bt_your_token_here"
      }
    }
  }
}

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.

ParameterRequiredDescription
nameYesBot name (max 50 chars)
descriptionNoBot description

botbell_send

Send a push notification via a specific bot.

ParameterRequiredDescription
bot_idYesBot ID (use botbell_list_bots to find)
messageYesMessage content (max 4096 chars)
titleNoNotification title
urlNoURL to attach (tappable)
image_urlNoImage URL to attach
actionsNoQuick reply buttons (max 5), see Actions

botbell_get_replies

Check for user replies to a specific bot.

ParameterRequiredDescription
bot_idYesBot ID to check
limitNoMax replies to fetch (default 20)

Bot Token Mode (bt_ token)

botbell_send

Send a push notification.

ParameterRequiredDescription
messageYesMessage content (max 4096 chars)
titleNoNotification title
urlNoURL to attach (tappable)
image_urlNoImage URL to attach
actionsNoQuick reply buttons (max 5), see Actions

botbell_get_replies

Fetch user replies from the BotBell app.

ParameterRequiredDescription
limitNoMax replies to fetch (default 20)

Extra Tokens

If you need to send notifications to bots from multiple accounts, you can configure additional Bot Tokens via the BOTBELL_EXTRA_TOKENS environment variable.

Format: alias1:bt_token1,alias2:bt_token2

{
  "mcpServers": {
    "botbell": {
      "command": "botbell-mcp",
      "env": {
        "BOTBELL_TOKEN": "pak_your_pat_here",
        "BOTBELL_EXTRA_TOKENS": "team-ops:bt_abc123,home:bt_xyz789"
      }
    }
  }
}

When extra tokens are configured:

  • The alias parameter becomes available on botbell_send and botbell_get_replies
  • Use alias to route messages through a specific extra token
  • In PAT mode, botbell_list_bots shows extra bots alongside your own
  • Without alias, the primary token (BOTBELL_TOKEN) is used as default

For Cursor / Other MCP Clients

Add to your MCP config:

{
  "botbell": {
    "command": "botbell-mcp",
    "env": {
      "BOTBELL_TOKEN": "pak_your_pat_here"
    }
  }
}

Actions

Add interactive buttons to your notifications. Users can tap to reply without typing.

{
  "message": "Deploy v2.3 to production?",
  "actions": [
    { "key": "approve", "label": "Yes" },
    { "key": "reject", "label": "No" },
    { "key": "custom", "label": "Other...", "type": "input", "placeholder": "Enter reason" }
  ]
}
FieldRequiredDescription
keyYesIdentifier returned when user taps (max 64 chars)
labelYesButton text shown to user (max 64 chars)
typeNo"button" (default) or "input" (opens text field)
placeholderNoPlaceholder for input field (max 128 chars)

When the user taps an action, botbell_get_replies returns the action key along with the message content:

[2026-01-15T10:30:00.000Z] [action:approve] Yes

Lightweight Alternatives

If MCP is more than you need:

  • SDKs — Call the REST API directly from your code:
    • Python: pip install botbell (PyPI · GitHub)
    • JavaScript: npm install @botbell/sdk (npm · GitHub)
  • Agent Skill — One command to install, zero dependencies, works with 30+ AI tools: BotBell Agent Skill

Links

Ver o original no GitHub

Bom para

Relacionados