WhatsApp MCP by TimelinesAI

TimelinesAI の WhatsApp MCP

チームの WhatsApp 受信トレイを、Claude、ChatGPT、Cursor、その他の AI アシスタントから操作できます。

TimelinesAI の WhatsApp 受信トレイを Claude、ChatGPT、Cursor、Codex、Grok、その他の MCP クライアントに接続できます。返信が必要なチャットを確認し、プロンプトから返信、リアクション、ラベル付け、担当者の割り当てを行えます。通常の WhatsApp 番号と WhatsApp Business API（WABA）番号の両方に対応し、34 個のツールをすべてあなた自身として実行できます。

TimelinesAI のすべてのプランに追加料金なしで含まれています。 ウェブサイト · セットアップガイド · MCP Academy

---

これは何ですか？

TimelinesAI MCP サーバーは、TimelinesAI 内にある実際の WhatsApp 受信トレイを遠隔操作するためのものです。TimelinesAI のログイン情報で一度接続すると、AI アシスタントは、通常の WhatsApp 番号（QR コードで接続）と **WhatsApp Business API（WABA）**番号の両方について、チャットの検索、メッセージ送信、トリアージ（ラベル＋割り当て）、ワークスペースの情報確認に使える 34 個のツールを利用できるようになります。

これはホスト型サーバーです。インストールも API キーも不要です。アシスタントは https://mcp.services.timelines.ai/mcp に接続し、一度サインインするだけです。

サンドボックスではありません。書き込みは実際に行われ、連絡先にも表示されます。受信者には、メッセージが UI から送られたのか、AI アシスタントから送られたのかはわかりません。どちらもあなたから送られたメッセージとして扱われます。

必要条件

• TimelinesAI アカウントと、ワークスペースに少なくとも 1 つ接続済みの WhatsApp 番号が必要です。番号が接続されていない場合、ほとんどのツールは空の結果またはエラーを返します。MCP はサンドボックスではなく、実際の受信トレイを遠隔操作するためのものです。
• リモート MCP サーバーに対応した AI アシスタントが必要です（以下のクライアントはすべて対応しています）。

TimelinesAI アカウントをまだお持ちでない場合は、10 日間の無料トライアルを開始 →

---

クイックセットアップ（約 1 分）

すべてのクライアントで使うサーバー URL：https://mcp.services.timelines.ai/mcp

ChatGPT

**ChatGPT の TimelinesAI プラグイン**を開き、接続をクリックして、TimelinesAI アカウントでサインインします。次に、*「@TimelinesAI 今日、私の対応が必要なものは？」*と質問します。

Claude（claude.ai と Claude Desktop）

Claude でカスタマイズ → コネクター → カスタムコネクターを追加を開き、サーバー URL を貼り付けて、TimelinesAI アカウントでサインインします。

Claude Code

claude mcp add --transport http timelinesai https://mcp.services.timelines.ai/mcp

初めてツールを使用するときに、Claude Code によってブラウザーのタブが開きます。TimelinesAI アカウントでサインインします。

プラグインを使う場合は、/plugin marketplace add InitechSoftware/whatsapp-mcp-by-timelinesai を実行してから、/plugin install timelinesai-whatsapp@timelinesai を実行します。プラグインはローカルプロキシを起動するため、Node.js 18+ が必要です。上記のコマンドには必要ありません。

Cursor

Cursor に追加（ワンクリック）、または ~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "timelinesai": {
      "url": "https://mcp.services.timelines.ai/mcp"
    }
  }
}

最初のツール呼び出し時に、サインインウィンドウが開きます。

Codex

~/.codex/config.toml に追加します。

[mcp_servers.timelinesai]
url = "https://mcp.services.timelines.ai/mcp"

次に、codex mcp login timelinesai を一度実行し、ブラウザーで承認します。Codex は自動でサインインを開始しません。

Grok Build

grok mcp add timelinesai https://mcp.services.timelines.ai/mcp

次に、/mcps と入力して timelinesai を選択し、i を押してサインインします。Grok Build は自動でサインインを開始しません。

その他の MCP クライアント

https://mcp.services.timelines.ai/mcp をリモートサーバー（ストリーミング可能な HTTP）として追加し、プロンプトが表示されたらサインインします。

すぐにコピーして使える設定ファイルについては、examples/ を参照してください。

---

まず試すこと

接続したら、アシスタントに次のように尋ねてください。

「今日、私が対応すべきことは何ですか？」

または、機能をひととおり確認するには、次のように尋ねます。

「timelinesai MCP サーバーが公開しているツールを教えてください。用途別に分類し、各グループにつきプロンプトの例を1つ示してください。」

---

ツール一覧（34個）

ツールは2つの並行したセット（QRコードで接続した通常の WhatsApp 番号用と、WhatsApp Business API（WABA）番号用）に分かれており、さらに両方で共有するワークスペースツールが3つあります。番号に合ったセットを使用してください。workspace_whatsapp_accounts は QR 接続した番号を、waba_accounts は WABA 番号を一覧表示します。

グループ	ツール数
ワークスペース（共有）	3
WhatsApp：QR 接続した番号	14
WhatsApp Business API（WABA）	17
合計	34

ワークスペース：3個のツール

読み取り専用の情報確認です。呼び出しコストは低く、両方のセットで共有されます。

ツール	用途
workspace_quotas	現在のプラン、シート数、メッセージ送信と API 呼び出しのクォータ、請求期間
workspace_whatsapp_accounts	接続済み QR WhatsApp アカウント（ID、電話番号、所有者、ステータス）
workspace_team	チームメンバー、役割、招待ステータス、アカウントの紐付け。両方のセットで担当者のメールアドレスを確認する際に使用します

WhatsApp（QR 接続した番号）：14個のツール

チャットの検索と確認：4個のツール

チャットの閲覧と読み取りを行います。書き込みはありません。

ツール	用途
list_chats	ステータス、ラベル、担当者、グループ／ダイレクト、電話番号、名前、日付、WA アカウントでチャットを絞り込みます。ページあたり50件
chat_details	1件のチャットのメタデータ全体
chat_history	チャット内のメッセージを一覧表示します。日付と方向で絞り込み、メッセージ UID カーソルでページ送りできます
message_details	1件のメッセージを確認します

メッセージ送信：4個のツール

クォータを消費します。 TimelinesAI UI と同じ月間メッセージ送信枠を使用します。

ツール	用途
chat_send_message	既存のチャットでメッセージ（テキスト、添付ファイル、返信）を送信します
whatsapp_account_send_message	特定の WA アカウントから任意の電話番号にメッセージを送信します（チャットが存在しない場合は新規作成します：新規宛ての送信）
message_reply	特定のメッセージにスレッド形式で返信します
message_react	メッセージの絵文字リアクションを設定または解除します

チャットの変更：6個のツール

チャットの状態変更とトリアージを行います。ラベルの設定と担当者の割り当ては冪等です。

ツール	用途
chat_open	クローズ済みのチャットを再開します
chat_close	チャットをクローズします
chat_assign	メールアドレスでチャットをチームメンバーに割り当てます（メールアドレスの確認には workspace_team を使用します）
chat_unassign	現在の担当チームメンバーの割り当てを解除します
chat_set_label	チャットにラベルを追加します
chat_remove_label	チャットからラベルを削除します

WhatsApp Business API（WABA）：17個のツール

アカウントとチャットの検索：5個のツール

チャットの閲覧と読み取りを行います。書き込みはありません。

ツール	用途
waba_accounts	送信に使用できる WABA 番号。id を waba_account_id として使用します
waba_list_chats	閲覧できる WABA チャット。オープン／クローズ、担当者、WABA アカウント、電話番号で絞り込み、1ページあたり50件を表示します。送信前に service_window_is_open を確認してください
waba_chat_details	1件の WABA チャットのサービスウィンドウ、担当者、ラベル、WABA アカウント
waba_chat_history	WABA チャット内のメッセージを新しい順に表示します。日付と方向で絞り込み、メッセージ UID カーソルでページ送りできます
waba_message_details	1件の WABA メッセージを確認します。送信に失敗した場合は failure_reason が含まれます

テンプレート：2 個のツール

ツール	目的
waba_templates	使用できるメッセージテンプレートを取得します。1 ページあたり 50 件です。送信できるのは APPROVED のテンプレートのみです
waba_template_details	1 つのテンプレートのコンポーネント、ステータス、送信元として利用できる WABA アカウントを取得します。テンプレートを送信する前に呼び出してください

メッセージ送信：4 個のツール

テンプレートの送信には Meta の料金が発生します。 チャットのサービスウィンドウが開いている場合に限り、無料のテキストメッセージを送信できます。

ツール	目的
waba_start_chat	承認済みテンプレートを使って電話番号との新しいチャットを開始します。Meta の料金が発生します
waba_chat_send_message	既存の WABA チャットでテキストメッセージを送信します。service_window_is_open が true の場合に限ります
waba_chat_send_template	既存の WABA チャットで承認済みテンプレートを送信します。サービスウィンドウが閉じている場合にメッセージを送る方法です。Meta の料金が発生します
waba_message_react	WABA メッセージに絵文字リアクションを設定または削除します

チャットの変更：6 個のツール

WABA チャットの状態管理とトリアージを行います。変更後は waba_chat_details を呼び出すと、確定した状態を確認できます。

ツール	目的
waba_chat_open	閉じた WABA チャットを再開します
waba_chat_close	WABA チャットを閉じます
waba_chat_assign	メールアドレスで WABA チャットをチームメイトに割り当てます（workspace_team のメンバー）
waba_chat_unassign	WABA チャットの担当者を解除します
waba_chat_set_label	既存のラベルを保持したまま、ラベルを追加します
waba_chat_remove_label	ほかのラベルを保持したまま、指定したラベルを削除します。チャットにそのラベルがない場合は何も行いません

→ スキーマとプロンプトの例：docs/tools.md

---

サインインの仕組み

サーバーは OAuth を使用します。アシスタントが初めて接続すると、TimelinesAI のブラウザーウィンドウが開きます。TimelinesAI アカウントにサインインして、アクセスを承認してください。アシスタントはサインイン状態を保持するため、次回以降のセッションでは確認を求めずに再接続できます。

ブラウザーで TimelinesAI にすでにサインインしている場合、承認はワンクリックで完了します。

すべての操作はあなたとして実行されます。TimelinesAI におけるあなたのロールの権限は、MCP の呼び出しにも UI 操作と同じように適用されます。

---

安全性と本番環境での動作

⚠️ この MCP サーバーは実際の WhatsApp 受信トレイを操作します。 メッセージを送信する前に、このセクションをお読みください。

• MCP 経由で送信されたメッセージは、UI から送信されたメッセージと見分けがつきません。 受信者には区別できません。
• 書き込み操作は実際に即時実行されます。 元に戻すことはできません。一括操作の前に確認してください。
• クォータは UI の使用量と共有されます。 MCP のメッセージは同じ月間メッセージ予算を消費します。残りの利用可能量を確認するには workspace_quotas を呼び出してください。
• WABA テンプレートメッセージには Meta の料金が発生します。 waba_start_chat と waba_chat_send_template は承認済みテンプレートを送信し、Meta から請求されます。テキストメッセージを送信する waba_chat_send_message は、チャットのサービスウィンドウが開いている場合に限り使用できます。
• サンドボックスモードはありません。 不安な場合は、まず自分の電話番号で試してください。
• WhatsApp の電話番号が接続されていない場合、ほとんどのツールは空の結果またはエラーを返します。先に TimelinesAI で電話番号を接続してください。

---

はじめに

1. TimelinesAI の 10 日間無料トライアルを開始 →
2. TimelinesAI ダッシュボードで WhatsApp の電話番号を接続します。
3. 上記からアシスタントを選び、接続します。
4. サインインして、「今日、私が対応すべきことは何ですか？」と尋ねます。

---

リンク

• WhatsApp MCP ページ：timelines.ai/whatsapp-mcp
• セットアップガイド：timelines.ai/whatsapp-mcp-guide
• MCP Academy（短いレッスン、登録不要）：timelines.ai/academy/mcp
• 登録：app.timelines.ai/register
• MCP サーバーエンドポイント：https://mcp.services.timelines.ai/mcp
• Model Context Protocol：modelcontextprotocol.io
• 問題／フィードバック：このリポジトリで問題を報告

---

ライセンス

MIT © 2026 Initech Software / TimelinesAI