cybozu-office-mcp

サイボウズ Office 10（パッケージ版） の連携API（SOAP）で予定を読み書きする、非公式の MCP サーバーです。

ツール

• 書き込みはプレビュー → confirm=true の2段階。プレビューで参加者・会議室の重なりを表示し、版（version）が変わっていれば実行しません。

• 予定の本文にプロンプトインジェクションが紛れる可能性があるため、書き込みツールは「常に許可」にしないことを推奨します。

• サーバー負荷対策: 要求は直列化、DBロック時は 1/2/4/8 秒で最大4回再試行、マスタは1時間・予定は60秒キャッシュ。

• http:// は既定で拒否（CYBOZU_ALLOW_HTTP=1 で許可）。

Related MCP server: Google Calendar MCP Server

インストール

Claude デスクトップ: Releases の cybozu-office.mcpb を開き、URL・ログイン名・パスワード（必要なら Basic 認証）を入力。

ソースから（Node.js 18+）:

git clone https://github.com/KimMaru10/cybozu-office-mcp.git && cd cybozu-office-mcp
npm ci && npm run build
security add-generic-password -s cybozu-mcp -a '<login>' -w   # macOS: パスワードをキーチェーンへ
CYBOZU_URL='https://example.co.jp/cgi-bin/cbag/ag.cgi' CYBOZU_USERNAME='<login>' node dist/check.js   # 接続確認

claude mcp add cybozu-office \
  -e CYBOZU_URL='https://example.co.jp/cgi-bin/cbag/ag.cgi' \
  -e CYBOZU_USERNAME='<login>' \
  -- node /path/to/cybozu-office-mcp/dist/index.js

制限事項

• 時刻は5分単位、日本時間（UTC+9）固定（タイムゾーン設定が日本以外のユーザーは時刻がずれる可能性あり）。

• 繰り返し: 「この回だけ」の変更は同日内の時刻変更のみ／第5週指定不可（「最終週」を使用）／日またぎ不可／「毎日（土日除く）」の祝日の扱いは未確認。

• 参加者への組織の指定は非対応（既存の組織参加者は変更時も維持）。

• フォロー付き予定の変更でフォローが残るかは未確認。ファシリテーター・出欠確認・コメントは非対応。通知メールはサイボウズ側の設定次第。

• cybozu_find_free_rooms は会議室ごとに1要求。多い場合は query で絞ってください。

• パッケージ版 Office のサポートは2027年に終了します。

動作確認

実サーバーはブラウザのログイン状態でAPIを呼んで確認（書き込みは自分だけの非公開テスト予定と、同僚の了承を得た実際の打ち合わせ1件）。

開発

npm ci
npm run typecheck
npm test        # ビルド＋模擬サーバー（test/）での結合テスト
npm run pack    # cybozu-office.mcpb を生成

リリース: package.json と bundle/manifest.json の version を上げ、npm test && npm run pack して Releases に .mcpb を添付。

謝辞・商標・ライセンス

• API の呼び出し方は hatashinya/cybozu-connect を参考にしました（コードは含みません）。

• 「サイボウズ」「サイボウズ Office」はサイボウズ株式会社の登録商標です。

• MIT。同梱依存のライセンスは THIRD_PARTY_LICENSES.txt。