remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables messaging (send text messages) and group management (create groups, list members, add/remove participants) through the WhatsApp Business API via GreenAPI

WhatsApp MCP サーバー

FastMCP を使用して WhatsApp Business API と対話するためのモデルコンテキストプロトコル (MCP) インターフェイスを提供するサーバー。

導入

WhatsApp MCPサーバーは、Claudeなどの言語モデルがGreenAPIを介してWhatsApp機能と連携できるようにするPython実装です。FastMCPを活用することで、パフォーマンスの向上、開発者エクスペリエンスの向上、そしてよりクリーンな実装を実現します。

特徴

メッセージング: WhatsAppの連絡先にテキストメッセージを送信する
グループ管理: グループの作成、メンバーの一覧表示、参加者の追加/削除
セッション処理: WhatsApp APIセッションを管理する
チャット履歴: チャットリストとメッセージ履歴を取得します

WhatsApp APIクライアント

このプロジェクトではwhatsapp-api-client-pythonライブラリを使用してWhatsAppとやり取りします。クライアントはWhatsApp Cloud APIへのアクセスを提供しますが、使用するにはGreenAPIアカウントが必要です。

環境変数

このプロジェクトでは、構成に環境変数を使用します。

GREENAPI_ID_INSTANCE : GreenAPI IDインスタンス
GREENAPI_API_TOKEN : GreenAPI APIトークン

これらを環境で設定するか、提供されている.envファイルを使用することもできます (インストール手順を参照)。

インストール

# Clone the repository
git clone https://github.com/yourusername/whatsapp-mcp-server.git
cd whatsapp-mcp-server

# Install dependencies
pip install -e .

# Set up environment variables
cp .env-template .env
# Edit the .env file with your GreenAPI credentials

使用法

MCP サーバーを実行します。

# Run the MCP server on default host (127.0.0.1) and port (8000)
whatsapp-mcp

# Specify host and port
whatsapp-mcp --host 0.0.0.0 --port 9000

デバッグの場合:

whatsapp-mcp --debug

サーバーはモデルコンテキストプロトコル (MCP) を使用して通信し、FastMCP で実行している場合は HTTP または WebSocket 経由でアクセスできます。

利用可能なツール

open_session : 新しいWhatsAppセッションを開く
send_message : チャットにメッセージを送信する
get_chats : チャットのリストを取得する
create_group : 新しいWhatsAppグループを作成する
get_group_participants : グループの参加者を取得する

FastMCP API リファレンス

WhatsApp MCP サーバーは FastMCP を使用して、WebSocket と HTTP エンドポイントの両方を提供します。

WebSocket: ws://localhost:8000/mcp
HTTP: http://localhost:8000/mcp

curl などのツールを使用して API を直接テストできます。

# List available tools
curl -X POST http://localhost:8000/mcp/listTools

# Call a tool
curl -X POST http://localhost:8000/mcp/callTool \
  -H "Content-Type: application/json" \
  -d '{"name": "open_session", "arguments": {}}'

クロードコードに追加する方法

WhatsApp サーバーを Claude に追加するには、 claude mcp addコマンドを使用します。

# Add the WhatsApp MCP server
$ claude mcp add whatsapp -- whatsapp-mcp

# List existing MCP servers - Validate that the server is running
claude mcp list

# Start claude code
claude

クロードと一緒に使う

WhatsApp MCP サーバーが実行される場合は、会話の中で Claude を使用してサーバーと対話できます。

WhatsAppで認証する

Login to WhatsApp

メッセージを送信する

Send the "Hello" message to John Doe

Claude Desktopでの使用

Claude Desktop で WhatsApp MCP サーバーを使用するには、 claude_desktop_config.jsonファイルに追加する必要があります。

pip インストールの使用（推奨）

"mcpServers": {
  "whatsapp": {
    "command": "python",
    "args": ["-m", "whatsapp_mcp"]
  }
}

実行ファイルの使用

"mcpServers": {
  "whatsapp": {
    "command": "whatsapp-mcp"
  }
}

Dockerの使用

"mcpServers": {
  "whatsapp": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "-e", "GREENAPI_ID_INSTANCE=your_instance_id", "-e", "GREENAPI_API_TOKEN=your_api_token", "whatsapp-mcp-server"]
  }
}

Claude Desktop を起動する前に、GreenAPI 資格情報を環境変数として、または.envファイルで設定することを忘れないでください。

コマンドラインオプション

WhatsApp MCP サーバーは次のコマンドライン引数を受け入れます。

--debug : デバッグの詳細レベルを上げる
--host : サーバーをバインドするホスト (デフォルト: 127.0.0.1)
--port : サーバーをバインドするポート (デフォルト: 8000)

デバッグ

MCP サーバーのデバッグの場合:

MCP インスペクターを使用する: npx @modelcontextprotocol/inspector whatsapp-mcp
Claude デスクトップのログディレクトリ（macOS では通常~/Library/Logs/Claude/ ）でログを表示します。
インタラクティブな API ドキュメントについては、FastMCP Web インターフェース ( http://localhost:8000)にアクセスしてください。

発達

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
flake8 src/

# Run type checking
mypy src/

このプロジェクトでは、以下を含む最新のpyproject.toml構成を使用します。

アプリケーションの実行に必要なコア依存関係
開発依存関係はpip install -e ".[dev]"で利用可能

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Claude などの言語モデルが GreenAPI を介して WhatsApp Business API と対話できるようにし、メッセージの送信やグループの管理などの機能をサポートする Python サーバー。

Appeared in Searches

Connecting WhatsApp with Evolution email/calendar client