Chatwork MCP Server

Chatwork を AI から操作するための MCP (Model Context Protocol) サーバーです。

できること

Chatwork API v2 の操作を 31 個のツールとして公開しています。

| カテゴリ | ツール | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 自分の情報 | get_me / get_my_status / list_my_tasks / list_contacts | | チャット | list_rooms / create_room / get_room / update_room / delete_or_leave_room | | メンバー | list_room_members / update_room_members | | メッセージ | list_room_messages / post_room_message / read_room_messages / unread_room_message / get_room_message / update_room_message / delete_room_message | | タスク | list_room_tasks / create_room_task / get_room_task / update_room_task_status | | ファイル | list_room_files / get_room_file | | 招待リンク | get_room_link / create_room_link / update_room_link / delete_room_link | | コンタクト承認依頼 | list_incoming_requests / accept_incoming_request / reject_incoming_request |

前提

• Node.js 22（CI が想定しているバージョン）
• Chatwork の API トークン（発行方法は Chatwork API のドキュメント を参照）

セットアップ

Claude Desktop

1. Claude Desktop を起動
2. メニューから「設定」をクリック
3. 「開発者」タブをクリック
4. 「構成を編集」をクリック
5. ファイルビューワーで claude_desktop_config.json が示されるので、好みのエディタで開く
6. 以下の設定を入力する

{
  "mcpServers": {
    "chatwork": {
      "command": "npx",
      "args": ["@chatwork/mcp-server"],
      "env": {
        "CHATWORK_API_TOKEN": "YOUR_CHATWORK_API_TOKEN"
      }
    }
  }
}

Claude Code

以下のコマンドを実行してください。

claude mcp add chatwork -e CHATWORK_API_TOKEN=YOUR_CHATWORK_API_TOKEN -- npx -y @chatwork/mcp-server

トランスポート

既定は stdio です。上記の設定例はいずれも stdio で動作するため、変更は不要です。

Streamable HTTP

サーバを 1 箇所に立てて複数の利用者から使いたい場合は、Streamable HTTP で起動できます。

npx @chatwork/mcp-server --transport http --port 3000

stdio と違い、クライアントがサーバを起動することはありません。接続する前に自分で起動しておく必要があります。

| フラグ | 環境変数 | 既定値 | 備考 | | ----------------- | ------------------- | --------------------------- | ------------------------------------------------- | | --transport | MCP_TRANSPORT | stdio | stdio または http | | --port | PORT | 3000 | | | --host | HOST | 127.0.0.1 | | | --allowed-hosts | MCP_ALLOWED_HOSTS | localhost,127.0.0.1,[::1] | Host ヘッダの許可リスト。既定はループバックのみ |

--allowed-hosts はホスト名だけを照合します。ポート番号は指定しても無視され、 起動時に stderr へ警告を出します（localhost:3000 は localhost として扱われます）。 IPv6 アドレスは角括弧付きで指定してください（[::1]）。

エンドポイントは POST /mcp です。API トークンは環境変数ではなくリクエストヘッダで渡します。

Authorization: Bearer YOUR_CHATWORK_API_TOKEN

ヘッダが無い場合は 401 を返します。stdio モードと違い、CHATWORK_API_TOKEN 環境変数へのフォールバックは行いません（サーバの環境変数のアカウントとして 第三者に操作されるのを防ぐため）。

開発

git clone https://github.com/chatwork/chatwork-mcp-server.git
cd chatwork-mcp-server
npm ci

| コマンド | 内容 | | -------------------- | ----------------------------------------------- | | npm run build | esbuild で dist/index.js にバンドルする | | npm run dev | ビルドを watch モードで実行する | | npm test | Vitest でテストを実行する（.env.test が必要） | | npm run type-check | TypeScript の型チェック | | npm run lint | ESLint + Prettier のチェック |

Streamable HTTPでの起動する

npm run start:http                   # 127.0.0.1:3000 で待ち受ける
npm run start:http -- --port 3001    # 追加のフラグは -- の後ろに書く

MCP Inspectorで動作確認する

inspector.example.json をコピーしてトークンを書き込み、npm run inspect で起動します。

cp inspector.example.json inspector.json    # Authorization の値を自分のトークンに書き換える
npm run inspect

サーバは別のターミナルで起動しておく必要があります。--port を変えた場合は inspector.json の url も合わせて変更してください。

Inspector の設定でヘッダを渡さずに接続すると、401 に付く WWW-Authenticate: Bearer を OAuth のチャレンジと解釈して OAuth フローに入り、接続に失敗します。 このサーバは OAuth に対応していないため、必ずヘッダで渡してください。

CLI モードから叩く場合は次のようにします。

npx @modelcontextprotocol/inspector --cli --config ./inspector.json \
  --server chatwork-http --method tools/list

コントリビュート

今後、MCP に対応した AI ツールが増える可能性があります。使い方を追加してほしいツールがあった場合、あなたのコントリビュートをお待ちしています！

バグ報告・要望は Issues へお願いします。

ライセンス

MIT