MCP Zoom Recordings
An MCP (Model Context Protocol) server that enables Claude to access and manage your Zoom cloud recordings.
Features
- list_recordings - List cloud recordings with date filtering (default: last 7 days)
- get_recording - Get recording details and download URLs for a specific meeting
Prerequisites
- Bun runtime
- Zoom account with cloud recording enabled
- Zoom Server-to-Server OAuth app
Setup
1. Create a Zoom Server-to-Server OAuth App
- Go to Zoom App Marketplace
- Click Develop > Build App
- Select Server-to-Server OAuth app type
- Fill in the required information and create the app
- Note down:
- Account ID (from App Credentials)
- Client ID (from App Credentials)
- Client Secret (from App Credentials)
2. Add Required Scopes
In your Zoom app settings, add these scopes:
cloud_recording:read:list_user_recordings:admincloud_recording:read:list_recording_files:admin
3. Activate the App
Click Activate your app to enable it.
4. Install Dependencies```bash
bun install
### 5. Build the Server```bash
bun run build
Configuration
Claude Desktop
Add to your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"zoom-recordings": {
"command": "node",
"args": ["/path/to/mcp-zoom-recordings/dist/index.js"],
"env": {
"ZOOM_API_KEY": "your-client-id",
"ZOOM_API_SECRET": "your-client-secret",
"ZOOM_ACCOUNT_ID": "your-account-id"
}
}
}
}
Replace `/path/to/mcp-zoom-recordings` with the actual path to this project.
### Claude Code CLI```bash
claude mcp add zoom-recordings -e ZOOM_API_KEY=your-client-id -e ZOOM_API_SECRET=your-client-secret -e ZOOM_ACCOUNT_ID=your-account-id -- node /path/to/mcp-zoom-recordings/dist/index.js
Environment Variables
| Variable | Description |
|---|---|
ZOOM_API_KEY |
Server-to-Server OAuth Client ID |
ZOOM_API_SECRET |
Server-to-Server OAuth Client Secret |
ZOOM_ACCOUNT_ID |
Your Zoom Account ID |
Usage
Once configured, you can ask Claude to interact with your Zoom recordings:
List Recent Recordings
> "Show me my Zoom recordings from the past week"
> "List all recordings from January 2024"
Get Recording Details
> "Get the download links for meeting abc123"
> "Show me the details of my last recorded meeting"
MCP Tools Reference
list_recordings
List Zoom cloud recordings for the authenticated account.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
from |
string | No | Start date (YYYY-MM-DD). Default: 7 days ago |
to |
string | No | End date (YYYY-MM-DD). Default: today |
page_size |
number | No | Results per page (1-300). Default: 30 |
next_page_token |
string | No | Token for pagination |
Returns: List of meetings with recording counts and metadata.
get_recording
Get detailed information and download URLs for a specific meeting's recordings.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
meeting_id |
string | Yes | Meeting UUID or meeting ID from list_recordings |
Returns: Recording details including download URLs for video, audio, transcripts, and chat logs.
Development```bash
Run with hot reload
bun run dev
Build for production
bun run build
Run linter
bun run lint
Fix lint issues
bun run lint:fix
Type check
bun run typecheck
Run tests
bun test
## Project Structure```
src/
├── index.ts # MCP server entry point
├── auth/ # Zoom Server-to-Server OAuth
│ ├── config.ts # Environment variable loading
│ └── zoom-auth.ts # Token management
├── clients/
│ └── zoom-client.ts # Zoom API wrapper
├── tools/
│ └── recordings/ # Recording tools
│ ├── list.ts # list_recordings
│ └── get.ts # get_recording
└── types/
└── recordings.ts # Type definitions
License
MIT