bluebubbles-mcp

Servidor MCP para BlueBubbles: accede a iMessage desde cualquier cliente MCP.

Construido desde cero sin dependencias MCP de terceros más allá del SDK oficial mcp y httpx.

Requisitos previos

Python 3.11+
Un servidor BlueBubbles en ejecución con acceso a la API habilitado

Configuración inicial

git clone https://github.com/metaember/bluebubbles-mcp.git
cd bluebubbles-mcp
uv sync

Configuración

Añádelo a la configuración de tu cliente MCP (por ejemplo, Claude Code ~/.claude/settings.json):

{
  "mcpServers": {
    "bluebubbles": {
      "command": "uv",
      "args": ["--directory", "/path/to/bluebubbles-mcp", "run", "python", "-m", "bb_mcp.server"],
      "env": {
        "BLUEBUBBLES_URL": "https://your-bluebubbles-server",
        "BLUEBUBBLES_PASSWORD": "your-server-password"
      }
    }
  }
}

Herramientas

Herramienta	Descripción	Anotaciones
`ping`	Comprobar la conectividad del servidor	solo lectura
`get_server_info`	Información y estado del servidor	solo lectura
`list_chats`	Listar conversaciones por actividad reciente	solo lectura
`get_chat`	Detalles del chat con participantes	solo lectura
`get_chat_messages`	Mensajes de un chat	solo lectura
`search_messages`	Buscar por texto, chat, rango de tiempo	solo lectura
`get_message`	Mensaje único por GUID	solo lectura
`get_contacts`	Todos los contactos	solo lectura
`lookup_contact`	Buscar por teléfono/correo electrónico	solo lectura
`check_imessage`	Comprobar registro de iMessage	solo lectura
`check_facetime`	Comprobar registro de FaceTime	solo lectura
`list_scheduled_messages`	Listar mensajes programados	solo lectura
`get_recent_messages`	Mensajes de los últimos N minutos en todos los chats	solo lectura
`get_unread_chats`	Chats con mensajes no leídos + sus últimos mensajes	solo lectura
`get_attachment_info`	Metadatos del archivo adjunto	solo lectura
`download_attachment`	Descargar archivo adjunto como base64	solo lectura
`mark_chat_read`	Enviar confirmación de lectura	idempotente, open-world
`mark_chat_unread`	Marcar chat como no leído (local)	idempotente
`rename_group`	Cambiar nombre de un chat grupal	idempotente
`start_typing`	Mostrar indicador de escritura	open-world
`stop_typing`	Detener indicador de escritura	open-world
`send_message`	Enviar a un chat existente	open-world
`send_message_to_address`	Enviar a teléfono/correo electrónico	open-world
`send_attachment`	Enviar un archivo adjunto	open-world
`send_reaction`	Reacción Tapback	open-world
`edit_message`	Editar un mensaje enviado	open-world
`schedule_message`	Programar un mensaje futuro	open-world
`add_participant`	Añadir a un chat grupal	open-world
`unsend_message`	Retractar un mensaje	destructivo, open-world
`remove_participant`	Eliminar de un chat grupal	destructivo, open-world
`leave_chat`	Abandonar un chat grupal	destructivo, open-world
`delete_chat`	Eliminar una conversación	destructivo, open-world
`delete_scheduled_message`	Cancelar mensaje programado	destructivo, open-world