bluebubbles-mcp

BlueBubbles 用のMCPサーバー — あらゆるMCPクライアントからiMessageにアクセスできます。

公式の mcp SDKと httpx 以外のサードパーティ製MCP依存関係を使用せず、ゼロから構築されています。

前提条件

Python 3.11以上
APIアクセスが有効な BlueBubblesサーバーが稼働していること

セットアップ

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`	サーバー接続の確認	read-only
`get_server_info`	サーバー情報と健全性	read-only
`list_chats`	最近のアクティビティ順に会話をリストアップ	read-only
`get_chat`	参加者を含むチャットの詳細	read-only
`get_chat_messages`	チャット内のメッセージ	read-only
`search_messages`	テキスト、チャット、時間範囲による検索	read-only
`get_message`	GUIDによる単一メッセージの取得	read-only
`get_contacts`	すべての連絡先	read-only
`lookup_contact`	電話番号/メールアドレスによる検索	read-only
`check_imessage`	iMessage登録の確認	read-only
`check_facetime`	FaceTime登録の確認	read-only
`list_scheduled_messages`	予約済みメッセージのリスト	read-only
`get_recent_messages`	全チャットの過去N分間のメッセージ	read-only
`get_unread_chats`	未読メッセージがあるチャットと最新メッセージ	read-only
`get_attachment_info`	添付ファイルのメタデータ	read-only
`download_attachment`	添付ファイルをbase64でダウンロード	read-only
`mark_chat_read`	既読通知を送信	idempotent, open-world
`mark_chat_unread`	チャットを未読にする（ローカル）	idempotent
`rename_group`	グループチャットの名前変更	idempotent
`start_typing`	入力中インジケーターを表示	open-world
`stop_typing`	入力中インジケーターを停止	open-world
`send_message`	既存のチャットに送信	open-world
`send_message_to_address`	電話番号/メールアドレスに送信	open-world
`send_attachment`	ファイル添付を送信	open-world
`send_reaction`	タップバックリアクション	open-world
`edit_message`	送信済みメッセージの編集	open-world
`schedule_message`	メッセージの送信予約	open-world
`add_participant`	グループチャットに追加	open-world
`unsend_message`	メッセージの取り消し	destructive, open-world
`remove_participant`	グループチャットから削除	destructive, open-world
`leave_chat`	グループチャットから退出	destructive, open-world
`delete_chat`	会話を削除	destructive, open-world
`delete_scheduled_message`	予約済みメッセージのキャンセル	destructive, open-world