MS Teams Meetings

Skill: ms-teams-meetings

Overview

• Use this skill to create and manage Microsoft Teams meetings via Microsoft Graph API.
• Capabilities:
  • Create Teams online meetings and send calendar invites
  • List upcoming Teams meetings
  • Cancel/delete an existing meeting (sends cancellation to attendees)

When to use

• Scheduling calls with business contacts where the meeting should be a Microsoft Teams meeting created under your Microsoft 365 account.
• Managing your Outlook/Exchange calendar events that are Teams-enabled.

Prerequisites

1. A Microsoft Entra ID (Azure AD) account with Outlook/Exchange Online (e.g., Microsoft 365 work/school or personal Microsoft account connected to Outlook).
2. App Registration in Microsoft Entra ID (Azure AD): a Public client (mobile & desktop) app with redirect URI http://localhost:53682 and the following Microsoft Graph delegated permissions:
   • User.Read
   • Calendars.ReadWrite
   • OnlineMeetings.ReadWrite Admin consent is typically NOT required for these delegated scopes in most tenants, but some orgs may require admin approval.
3. OAuth tokens will be stored at: ~/.openclaw/integrations/microsoft/tokens.json (permissions: 600). Config is at ~/.openclaw/integrations/microsoft/config.json.

Authentication (one-time)

• Run scripts/setup.py to guide you through OAuth. It will:
  • Ask for your Client ID (Application ID) and Tenant (common/organizations/consumers or your tenant ID).
  • Start a localhost redirect listener on http://localhost:53682
  • Open the Microsoft login/consent page in your browser (with PKCE)
  • Store tokens securely and refresh automatically when needed

Create a Teams meeting

• Script: scripts/create_meeting.py
• Inputs:
  • --title "Project Sync"
  • --attendees emails separated by comma (e.g., [email protected],[email protected])
  • --start-time "2026-02-25 10:00" (local time unless --timezone provided) OR ISO 8601
  • --duration-minutes 45
  • --timezone "Asia/Singapore" (IANA tz; defaults to your system tz if omitted)
• Output:
  • Teams join link and the created calendar event ID

List upcoming Teams meetings

• Script: scripts/list_meetings.py
• Shows your next N online meetings in the selected window.

Cancel a meeting

• Script: scripts/cancel_meeting.py
• Cancels the event and sends cancellation emails to attendees.

Installation

• Requires Python 3.10+
• First run installs dependencies automatically (msal, requests, python-dateutil, tzlocal)

Example usage

1. One-time auth setup python3 scripts/setup.py --client-id YOUR_APP_ID --tenant common

2. Create a meeting (45 min from 3pm SGT) python3 scripts/create_meeting.py
   --title "BD call with Acme"
   --attendees "[email protected],[email protected]"
   --start-time "2026-02-26 15:00"
   --duration-minutes 45
   --timezone "Asia/Singapore"

3. List next week's Teams meetings python3 scripts/list_meetings.py --days 7 --limit 20

4. Cancel a meeting python3 scripts/cancel_meeting.py --event-id EVENT_ID_FROM_CREATE

Notes

• Default tenant is "common". If your org blocks multi-tenant, use your tenant ID for --tenant.
• Time parsing accepts "YYYY-MM-DD HH:MM" or ISO 8601. If ambiguous, provide --timezone.
• Invites: Outlook sends invitations automatically when an event with attendees is created.