Had these files as part of local exp Kinda was clutering the system Folder reorg-ed courtesy Cowork

Microsoft Teams SDK - Meeting & Transcript Management

A Python SDK for creating Microsoft Teams meetings and managing transcripts using the Microsoft Graph API.

Features

• OAuth 2.0 authentication with PKCE flow
• Create Teams meetings with automatic recording and transcription
• Download meeting transcripts in VTT format
• Webhook subscriptions for transcript notifications
• Automatic token refresh

Prerequisites

• Python 3.7+
• Microsoft Azure App Registration with the following permissions:
  • OnlineMeetings.ReadWrite
  • OnlineMeetingTranscript.Read.All
  • User.Read

Setup

1. Clone and Install Dependencies

cd teams-sdk
pip install -r requirements.txt

2. Configure Environment Variables

Copy the example environment file and fill in your Azure app credentials:

cp env.example .env

Edit .env with your Azure app details:

CLIENT_ID=your-client-id-here
CLIENT_SECRET=your-client-secret-here
TENANT_ID=your-tenant-id-here
REDIRECT_URI=http://localhost:8000/callback

3. Azure App Registration

1. Go to Azure Portal
2. Navigate to Azure Active Directory > App registrations > New registration
3. Configure:
   • Name: Your app name
   • Redirect URI: http://localhost:8000/callback (or your custom URI)
4. After creation:
   • Copy the Application (client) ID → CLIENT_ID
   • Copy the Directory (tenant) ID → TENANT_ID
   • Go to Certificates & secrets → Create new client secret → Copy value → CLIENT_SECRET
5. Go to API permissions → Add permissions:
   • Microsoft Graph → Delegated permissions:
     • OnlineMeetings.ReadWrite
     • OnlineMeetingTranscript.Read.All
     • User.Read
   • Click Grant admin consent

Usage

Quick Start

cd meet-creation

# 1. First time: Authenticate
python auth.py

# 2. Create a meeting
python create_meeting_main.py

# 3. Download transcript (wait 5-15 mins after meeting ends)
python pull_transcript_main.py

Authentication

First, authenticate and save your tokens:

cd meet-creation
python auth.py

This will:

1. Open a browser for OAuth authentication
2. Save your access and refresh tokens to teams_tokens.json
3. Store user information

Note: teams_tokens.json is gitignored and should never be committed!

Creating a Meeting

python create_meeting_main.py

Features:

• Automatically refreshes expired tokens
• Creates meeting with recording and transcription enabled
• Returns meeting join URL and ID

Important: Save the meeting ID - you'll need it to download transcripts!

Downloading Transcripts

After a meeting ends (transcripts may take 5-15 minutes to be available):

python pull_transcript_main.py

Enter the meeting ID when prompted. Transcripts will be saved to the transcripts/ folder in VTT format.

Folder Organization

meet-creation/ - Main Scripts

Production Scripts (use these!):

• auth.py: OAuth authentication and token management
• create_meeting_main.py: Create meetings with auto-recording/transcription
• pull_transcript_main.py: Download meeting transcripts

See meet-creation/README.md for detailed documentation!

meet-creation/examples/ - Advanced Features

Experimental/advanced usage:

• webhook_handler.py: Flask server for real-time notifications
• transcript_poller.py: Automated transcript polling
• subscription_manager.py: Setup webhook subscriptions

meet-creation/utils/ - Diagnostic Tools

Troubleshooting and debugging:

• check_permissions.py: Verify Azure app permissions
• diagnosis.py: Comprehensive diagnostic information
• subscription_review.py: Review active subscriptions
• debug.py: Advanced debugging tools

meet-creation/archive/ - Archived Code

Older experimental code kept for reference (may not work with current setup)

teams_meeting_creation_context/ - Reusable Modules

Library modules for integration into other projects

Contributing

This is an experimental/personal project. Feel free to fork and adapt for your needs.

License

See LICENSE file for details.

Resources

• Microsoft Graph API Documentation
• Online Meetings API
• Transcript API