01 / Introduction

Zoom meets
Claude AI

AI-powered meeting management through natural language.
A full MCP server with a native macOS desktop app.

"Show my meetings for today" · "Create a standup at 10am" · "Who attended yesterday's call?"
9
Zoom API Tools
1
Command to Start
3
Branches / Builds
MIT
License
02 / Problem

Meeting Management
is Time-Consuming

Context switching and manual workflows add friction to every meeting interaction.

🔄

App Switching Overhead

Jumping between Calendar, Zoom portal, and browser wastes 5–10 minutes per meeting setup.

🔐

Manual Authentication

Zoom OAuth tokens expire every hour with no automatic refresh — causing silent failures mid-session.

🖱️

No Natural Language Interface

Finding recordings, listing attendees, or creating meetings requires navigating multiple UI layers.

03 / Solution

Zoom MCP:
AI-Native Meeting Control

Connect Claude Desktop directly to your Zoom account. Manage everything through conversation.

Before — Manual Workflow
  • Open Zoom portal in browser
  • Navigate to Meetings tab
  • Click New Meeting, fill form
  • Copy link back to calendar
  • Repeat for every change
After — With Zoom MCP
  • Open Claude Desktop
  • "Create a standup tomorrow 10am"
  • Done — link returned instantly
  • Token auto-refreshed in background
  • Ask follow-up questions naturally
04 / Architecture

System Architecture

A secure bridge from Claude to Zoom via the Model Context Protocol.

🖥️
Claude Desktop
AI interface — natural language
stdio / MCP Protocol
⚙️
MCP Server
index.js · Node.js 18+
⇄
🔑
Token Manager
Auto-refresh · anti-loop safeguards
HTTPS / OAuth 2.0
📹
Zoom API v2
REST · Server-to-Server OAuth
05 / Features

Key Capabilities

Engineered for reliability, security, and a seamless developer experience.

🔑

Smart Token Management

Validates before fetching. Only requests a new token when expired or within 5 min of expiry.

🔄

Auto Token Refresh

Background monitor with 30s cooldown and max 3 failure limit to prevent restart loops.

🛡️

iCloud-Safe Launcher

Avoids shell execution restrictions on macOS paths with spaces or iCloud Drive locations.

🚀

Claude Auto-Recovery

Multi-method startup verification, up to 15 retries. Auto-reopens Claude if it closes.

📊

Live Status Monitoring

Token expiry countdown with color-coded indicators: ✅ fresh, 📊 soon, ⚠️ critical.

🍎

Native macOS App

Electron app with real-time logs, one-click server controls, and token management.

06 / macOS App

Native Electron App

No terminal required. Manage Zoom MCP from a polished desktop interface.

Zoom MCP · macOS App
Online
🖥️
Claude
✅ Running
🔑
Token
57m 12s
⚡
Server
✅ Active
▶ Start
■ Stop
🔍 Token
🔁 Claude
Server Logs
✅ Claude Desktop is running ✅ Token valid. No refresh needed. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🚀 MCP Server running on stdio 🔄 Token monitoring active 🔑 Expires in 57m 12s (3:44 PM)
  • ▶️

    One-Click Server Control

    Start and stop the MCP server instantly with live status reflected in the dashboard.

  • 📋

    Live Log Viewer

    Terminal-style log panel with color-coded output streams server stdout/stderr in real time.

  • 🔐

    Token Panel

    View, check, and refresh your Zoom access token — with source attribution.

  • 🔁

    Restart Claude

    Purple gradient button restarts Claude Desktop after token refreshes that require config reload.

  • 📦

    Distributable .app + .dmg

    Build for arm64 and x64 with ./build-app.sh. Drop in dist/ and ship.

07 / MCP Tools

9 Zoom API Tools

Everything Claude needs to manage your Zoom account through natural language.

📋
list_meetings
Scheduled, live, upcoming, previous
🔍
get_meeting
Full details for a meeting ID
➕
create_meeting
Topic, time, duration, settings
✏️
update_meeting
Edit time, agenda, password
🗑️
delete_meeting
Cancel a meeting by ID
👥
list_users
Active, inactive, pending users
👤
get_user
User by ID or email
🙋
get_meeting_participants
Attendee list for past meetings
🎬
get_meeting_recordings
Cloud recording links & metadata
08 / Setup

Get Running in 4 Steps

From clone to Claude in minutes.

1

Clone & Install

git clone the repo and run npm install.

2

Configure

Copy .env.example → .env. Add your Zoom OAuth credentials.

3

Edit Claude Config

Add the zoom entry pointing to launch-mcp.js.

4

Restart Claude

Reopen Claude Desktop. Start talking to Zoom.

claude_desktop_config.json
JSON
{ "mcpServers": { "zoom": { "command": "node", "args": ["/absolute/path/to/zoommcp/launch-mcp.js"] } } }
09 / Demo

Natural Language
in Action

Real prompts you can ask Claude once Zoom MCP is connected.

📋
"Show me my upcoming Zoom meetings for this week"
➕
"Create a team standup meeting tomorrow at 10am EST for 30 minutes"
👥
"Who attended yesterday's client call?"
🎬
"Get the recording link from last week's project review"
✏️
"Update meeting 123456789 — change the start time to 2pm"
🗑️
"Cancel the Zoom meeting with ID 987654321"
10 / Get Started

Ready to talk to
Zoom through Claude?

Open source, MIT licensed, and built for developers who want AI-native Zoom control.

⭐ View on GitHub ← Back to Homepage 📊 Executive Summary
⎇ main ⎇ feature/macos-app ⎇ feature/openai