bluebubbles-mcp

MCP-сервер для BlueBubbles — доступ к iMessage из любого MCP-клиента.

Создан с нуля без сторонних MCP-зависимостей, кроме официального SDK mcp и httpx.

Предварительные требования

Python 3.11+
Запущенный сервер BlueBubbles с включенным API-доступом

Установка

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

Конфигурация

Добавьте в конфигурацию вашего MCP-клиента (например, 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"
      }
    }
  }
}

Инструменты

Инструмент	Описание	Аннотации
`ping`	Проверка соединения с сервером	только для чтения
`get_server_info`	Информация о сервере и его состоянии	только для чтения
`list_chats`	Список переписок по недавней активности	только для чтения
`get_chat`	Детали чата с участниками	только для чтения
`get_chat_messages`	Сообщения из чата	только для чтения
`search_messages`	Поиск по тексту, чату, временному диапазону	только для чтения
`get_message`	Одиночное сообщение по GUID	только для чтения
`get_contacts`	Все контакты	только для чтения
`lookup_contact`	Поиск по телефону/email	только для чтения
`check_imessage`	Проверка регистрации в iMessage	только для чтения
`check_facetime`	Проверка регистрации в FaceTime	только для чтения
`list_scheduled_messages`	Список запланированных сообщений	только для чтения
`get_recent_messages`	Сообщения за последние N минут во всех чатах	только для чтения
`get_unread_chats`	Чаты с непрочитанными сообщениями + их последние сообщения	только для чтения
`get_attachment_info`	Метаданные вложения	только для чтения
`download_attachment`	Скачивание вложения в формате base64	только для чтения
`mark_chat_read`	Отправить уведомление о прочтении	идемпотентный, open-world
`mark_chat_unread`	Пометить чат как непрочитанный (локально)	идемпотентный
`rename_group`	Переименовать групповой чат	идемпотентный
`start_typing`	Показать индикатор набора текста	open-world
`stop_typing`	Остановить индикатор набора текста	open-world
`send_message`	Отправить в существующий чат	open-world
`send_message_to_address`	Отправить на номер телефона/email	open-world
`send_attachment`	Отправить файловое вложение	open-world
`send_reaction`	Реакция Tapback	open-world
`edit_message`	Редактировать отправленное сообщение	open-world
`schedule_message`	Запланировать сообщение на будущее	open-world
`add_participant`	Добавить в групповой чат	open-world
`unsend_message`	Отозвать сообщение	деструктивный, open-world
`remove_participant`	Удалить из группового чата	деструктивный, open-world
`leave_chat`	Покинуть групповой чат	деструктивный, open-world
`delete_chat`	Удалить переписку	деструктивный, open-world
`delete_scheduled_message`	Отменить запланированное сообщение	деструктивный, open-world

Лицензия

MIT

bluebubbles-mcp

bluebubbles-mcp

Предварительные требования

Установка

Конфигурация

Инструменты

Лицензия

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API