Teams会議の日程調整・議事録作成をClaude Codeに自動化させた体験記【2026年版】

#!/usr/bin/env python3
# create_teams_meeting.py
# Claude Code が生成：Teams会議をGraph APIで自動作成するスクリプト

import os
import logging
from datetime import datetime
from typing import List, Optional
import requests
from msal import ConfidentialClientApplication

logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s [%(levelname)s] %(message)s"
)
logger = logging.getLogger(__name__)

TENANT_ID     = os.environ["AZURE_TENANT_ID"]
CLIENT_ID     = os.environ["AZURE_CLIENT_ID"]
CLIENT_SECRET = os.environ["AZURE_CLIENT_SECRET"]
GRAPH_SCOPE   = ["https://graph.microsoft.com/.default"]

def get_access_token() -> str:
    """Azure AD クライアントシークレット認証でトークンを取得"""
    app = ConfidentialClientApplication(
        CLIENT_ID,
        authority=f"https://login.microsoftonline.com/{TENANT_ID}",
        client_credential=CLIENT_SECRET,
    )
    result = app.acquire_token_for_client(scopes=GRAPH_SCOPE)
    if "access_token" not in result:
        raise RuntimeError(f"トークン取得失敗: {result.get('error_description')}")
    logger.info("アクセストークン取得成功")
    return result["access_token"]

def create_teams_meeting(
    organizer_user_id: str,
    title: str,
    start_dt: datetime,
    end_dt: datetime,
    attendees: List[str],
    body_content: Optional[str] = None,
    time_zone: str = "Asia/Tokyo",
) -> dict:
    """
    Graph API でTeams会議（オンライン会議リンク付き）を作成する。

    Args:
        organizer_user_id: 主催者のAzure AD ユーザーID（またはメールアドレス）
        title: 会議タイトル
        start_dt: 開始日時（タイムゾーンなしdatetimeはtime_zoneに従う）
        end_dt: 終了日時
        attendees: 参加者メールアドレスのリスト
        body_content: 招待メール本文（省略可）
        time_zone: タイムゾーン文字列（デフォルト: Asia/Tokyo）

    Returns:
        作成されたイベントオブジェクト（dict）
    """
    token = get_access_token()
    headers = {
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json",
    }

    attendee_list = [
        {
            "emailAddress": {"address": email, "name": email.split("@")[0]},
            "type": "required",
        }
        for email in attendees
    ]

    payload = {
        "subject": title,
        "start": {
            "dateTime": start_dt.strftime("%Y-%m-%dT%H:%M:%S"),
            "timeZone": time_zone,
        },
        "end": {
            "dateTime": end_dt.strftime("%Y-%m-%dT%H:%M:%S"),
            "timeZone": time_zone,
        },
        "attendees": attendee_list,
        "isOnlineMeeting": True,
        "onlineMeetingProvider": "teamsForBusiness",
        "body": {
            "contentType": "HTML",
            "content": body_content or f"<p>{title} にご参加ください。</p>",
        },
    }

    url = f"https://graph.microsoft.com/v1.0/users/{organizer_user_id}/events"
    logger.info(f"会議作成リクエスト送信: {title}")

    try:
        resp = requests.post(url, headers=headers, json=payload, timeout=30)
        resp.raise_for_status()
        event = resp.json()
        logger.info(f"会議作成完了 ID: {event['id'][:20]}...")
        logger.info(f"参加URL: {event.get('onlineMeeting', {}).get('joinUrl', 'N/A')}")
        return event
    except requests.exceptions.HTTPError as e:
        logger.error(f"Graph API エラー {e.response.status_code}: {e.response.text}")
        raise

# ---- 実行例 ----
if __name__ == "__main__":
    event = create_teams_meeting(
        organizer_user_id="me@aurant-technologies.com",
        title="2026年5月 月次レビュー",
        start_dt=datetime(2026, 5, 10, 10, 0),
        end_dt=datetime(2026, 5, 10, 11, 0),
        attendees=[
            "tanaka@aurant-technologies.com",
            "suzuki@aurant-technologies.com",
            "yamada@aurant-technologies.com",
        ],
    )
    print(f"作成完了: {event['subject']}")
    print(f"参加リンク: {event['onlineMeeting']['joinUrl']}")

#!/usr/bin/env python3
# find_and_schedule.py
# Claude Code が生成：空き時間確認＆自動招待スクリプト

import os
import logging
from datetime import datetime, timedelta
from typing import List
import requests
from msal import ConfidentialClientApplication

logger = logging.getLogger(__name__)

def find_meeting_times(
    organizer_id: str,
    attendees: List[str],
    duration_hours: int = 1,
    search_days: int = 5,
) -> List[dict]:
    """Graph API findMeetingTimes で空き時間候補を取得"""
    token = get_access_token()
    headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}

    # 翌営業日から検索開始
    start = datetime.now() + timedelta(days=1)
    end   = start + timedelta(days=search_days)

    attendee_list = [
        {"emailAddress": {"address": a}, "type": "required"}
        for a in attendees
    ]

    payload = {
        "attendees": attendee_list,
        "timeConstraint": {
            "activityDomain": "work",
            "timeSlots": [{
                "start": {"dateTime": start.strftime("%Y-%m-%dT09:00:00"), "timeZone": "Asia/Tokyo"},
                "end":   {"dateTime": end.strftime("%Y-%m-%dT18:00:00"),   "timeZone": "Asia/Tokyo"},
            }]
        },
        "meetingDuration": f"PT{duration_hours}H",
        "maxCandidates": 5,
        "isOrganizerOptional": False,
        "returnSuggestionReasons": True,
    }

    url = f"https://graph.microsoft.com/v1.0/users/{organizer_id}/findMeetingTimes"
    resp = requests.post(url, headers=headers, json=payload, timeout=30)
    resp.raise_for_status()
    suggestions = resp.json().get("meetingTimeSuggestions", [])
    logger.info(f"空き時間候補 {len(suggestions)} 件を取得")
    return suggestions

def interactive_schedule(organizer_id: str, attendees: List[str], meeting_title: str):
    """空き時間を提示してユーザー選択後に会議を自動作成"""
    suggestions = find_meeting_times(organizer_id, attendees)

    if not suggestions:
        print("😭 5営業日以内に全員参加可能な時間が見つかりませんでした。")
        return

    print("\n📅 空き時間候補（全員参加可能）:\n")
    for i, s in enumerate(suggestions, 1):
        slot = s["meetingTimeSlot"]
        score = s.get("confidence", 0)
        start_str = slot["start"]["dateTime"][:16].replace("T", " ")
        end_str   = slot["end"]["dateTime"][11:16]
        print(f"  {i}. {start_str} 〜 {end_str}  [参加可能率: {score:.0f}%]")

    choice = int(input("\n番号を入力して会議を確定してください: ")) - 1
    chosen = suggestions[choice]["meetingTimeSlot"]

    start_dt = datetime.fromisoformat(chosen["start"]["dateTime"])
    end_dt   = datetime.fromisoformat(chosen["end"]["dateTime"])

    # create_teams_meeting は シナリオ1のモジュールから import
    from create_teams_meeting import create_teams_meeting
    event = create_teams_meeting(organizer_id, meeting_title, start_dt, end_dt, attendees)
    print(f"\n✅ 会議を作成しました！")
    print(f"   タイトル : {event['subject']}")
    print(f"   日時     : {start_dt.strftime('%Y年%m月%d日 %H:%M')} 〜 {end_dt.strftime('%H:%M')}")
    print(f"   参加リンク: {event['onlineMeeting']['joinUrl']}")

if __name__ == "__main__":
    interactive_schedule(
        organizer_id="me@aurant-technologies.com",
        attendees=["tanaka@aurant-technologies.com", "kato@aurant-technologies.com"],
        meeting_title="プロジェクト進捗確認MTG",
    )

#!/usr/bin/env python3
# generate_minutes.py
# Claude Code が生成：トランスクリプト取得→Claude APIで議事録自動生成

import os, json, re, logging
from datetime import datetime
from pathlib import Path
import requests
import anthropic
from msal import ConfidentialClientApplication

logger = logging.getLogger(__name__)

# Claude Code が使うAnthropicクライアント初期化
claude = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

def get_transcript_content(organizer_id: str, meeting_id: str) -> str:
    """Graph API からVTTトランスクリプトを取得してテキスト変換"""
    token = get_access_token()
    headers = {"Authorization": f"Bearer {token}"}

    # トランスクリプト一覧を取得
    list_url = (
        f"https://graph.microsoft.com/v1.0/users/{organizer_id}"
        f"/onlineMeetings/{meeting_id}/transcripts"
    )
    resp = requests.get(list_url, headers=headers, timeout=30)
    resp.raise_for_status()
    transcripts = resp.json().get("value", [])

    if not transcripts:
        raise ValueError("この会議にはトランスクリプトがありません（Teams Premium が必要な場合あり）")

    # 最新のトランスクリプトを取得（VTT形式）
    latest_id = transcripts[-1]["id"]
    content_url = (
        f"https://graph.microsoft.com/v1.0/users/{organizer_id}"
        f"/onlineMeetings/{meeting_id}/transcripts/{latest_id}/content"
    )
    vtt_resp = requests.get(
        content_url, headers={**headers, "Accept": "text/vtt"}, timeout=60
    )
    vtt_resp.raise_for_status()
    return parse_vtt(vtt_resp.text)

def parse_vtt(vtt: str) -> str:
    """VTTファイルを話者付きテキストに変換"""
    lines = vtt.split("\n")
    result, current_speaker = [], ""
    for line in lines:
        m = re.match(r"^<v ([^>]+)>(.+)$", line.strip())
        if m:
            speaker, text = m.group(1), m.group(2)
            if speaker != current_speaker:
                result.append(f"\n【{speaker}】{text}")
                current_speaker = speaker
            else:
                result.append(f" {text}")
    return "".join(result).strip()

def generate_minutes(transcript: str, meeting_title: str, attendees: list) -> dict:
    """Claude APIを呼び出して議事録をJSON形式で生成"""
    logger.info("Claude API で議事録生成中...")

    prompt = f"""以下はMicrosoft Teams会議「{meeting_title}」のトランスクリプトです。
参加者: {", ".join(attendees)}

## トランスクリプト
{transcript[:6000]}

## 出力指示
以下のJSON形式で日本語の議事録を生成してください。
```json
{{
  "meeting_title": "会議タイトル",
  "date": "YYYY-MM-DD",
  "attendees": ["参加者リスト"],
  "summary": "会議全体の要約（200字以内）",
  "decisions": ["決定事項1", "決定事項2"],
  "action_items": [
    {{"task": "タスク内容", "owner": "担当者", "due": "YYYY-MM-DD", "priority": "高/中/低"}}
  ],
  "next_meeting": "次回会議の予定",
  "notes": "その他特記事項"
}}
```"""

    response = claude.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=4096,
        messages=[{"role": "user", "content": prompt}]
    )
    raw = response.content[0].text
    json_match = re.search(r"```json\s*([\s\S]+?)\s*```", raw)
    minutes = json.loads(json_match.group(1) if json_match else raw)
    logger.info("議事録生成完了")
    return minutes

def save_as_markdown(minutes: dict) -> Path:
    """議事録をMarkdownファイルに保存"""
    output_dir = Path("./minutes")
    output_dir.mkdir(exist_ok=True)
    ts = datetime.now().strftime("%Y%m%d_%H%M%S")
    path = output_dir / f"minutes_{ts}.md"

    actions_md = "\n".join([
        f"- [ ] [{a['priority']}] {a['task']} — **{a['owner']}**（期限: {a['due']}）"
        for a in minutes.get("action_items", [])
    ])
    decisions_md = "\n".join([f"- {d}" for d in minutes.get("decisions", [])])

    content = f"""# {minutes['meeting_title']} 議事録

**日時:** {minutes['date']}
**参加者:** {', '.join(minutes['attendees'])}
**生成:** Claude Code (claude-sonnet-4-6)

---

## 要約
{minutes['summary']}

## 決定事項
{decisions_md}

## アクションアイテム
{actions_md}

## 次回会議
{minutes.get('next_meeting', '未定')}

## 特記事項
{minutes.get('notes', 'なし')}
"""
    path.write_text(content, encoding="utf-8")
    logger.info(f"議事録保存: {path}")
    return path