@kindflow/zoom-mcp-server

MCP server that gives Claude Code native tool access to the Zoom API. Supports meetings, transcripts, users, and team chat.

Features

• Meeting Transcripts — Fetch and parse cloud recording transcripts into clean, readable text
• Meetings — List, create, update, and delete meetings; view past meeting participants
• Users — List and inspect account users
• Team Chat — List channels, read messages, and send messages
• Read-Only Mode — Safe by default; write tools only available when explicitly enabled

Prerequisites

You need a Zoom Server-to-Server OAuth app. Create one at marketplace.zoom.us:

1. Go to Develop > Build App > Server-to-Server OAuth
2. Add the required scopes for the APIs you want to use:
   • cloud_recording:read:admin — for transcripts and recordings
   • meeting:read:admin, meeting:write:admin — for meetings
   • user:read:admin — for users
   • chat_message:read:admin, chat_message:write:admin — for team chat
   • chat_channel:read:admin — for listing channels
3. Note your Account ID, Client ID, and Client Secret

Setup with Claude Code

Quick setup (CLI)

claude mcp add zoom -- npx @kindflow/zoom-mcp-server

Then set your environment variables in ~/.claude/settings.json under the zoom server entry.

Manual setup

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "zoom": {
      "command": "npx",
      "args": ["@kindflow/zoom-mcp-server"],
      "env": {
        "ZOOM_ACCOUNT_ID": "your-account-id",
        "ZOOM_CLIENT_ID": "your-client-id",
        "ZOOM_CLIENT_SECRET": "your-client-secret",
        "ZOOM_MODE": "readonly"
      }
    }
  }
}

Set ZOOM_MODE to readwrite to enable creating meetings, sending chat messages, etc.

Available Tools

Transcripts (Read)

Tool	Description
zoom_list_recordings	List cloud recordings for a user within a date range
zoom_get_meeting_transcript	Download and parse a meeting transcript into clean text
zoom_get_meeting_summary	Get AI-generated meeting summary (requires Zoom AI Companion)

Meetings (Read)

Tool	Description
zoom_list_meetings	List scheduled, live, upcoming, or previous meetings
zoom_get_meeting	Get meeting details including settings and join URL
zoom_list_past_meeting_participants	List who attended a past meeting

Meetings (Write — requires readwrite mode)

Tool	Description
zoom_create_meeting	Create a new meeting
zoom_update_meeting	Update an existing meeting
zoom_delete_meeting	Delete a meeting

Users (Read)

Tool	Description
zoom_list_users	List all users in the account
zoom_get_user	Get a specific user's details

Team Chat (Read)

Tool	Description
zoom_list_channels	List chat channels
zoom_list_chat_messages	List messages in a channel

Team Chat (Write — requires readwrite mode)

Tool	Description
zoom_send_chat_message	Send a message to a channel or user

Environment Variables

Variable	Required	Description
ZOOM_ACCOUNT_ID	Yes	Zoom Server-to-Server OAuth account ID
ZOOM_CLIENT_ID	Yes	Zoom app client ID
ZOOM_CLIENT_SECRET	Yes	Zoom app client secret
ZOOM_MODE	No	readonly (default) or readwrite

Troubleshooting

sh: zoom-mcp-server: command not found when using npx

This happens with asdf version manager. Use one of these alternatives:

Install globally, then reference directly:

npm install -g @kindflow/zoom-mcp-server

{
  "zoom": {
    "command": "zoom-mcp-server",
    "env": { ... }
  }
}

Or point to the installed file with node:

{
  "zoom": {
    "command": "node",
    "args": ["node_modules/@kindflow/zoom-mcp-server/dist/index.js"],
    "env": { ... }
  }
}

Development

git clone https://github.com/surajpratap/zoom-mcp-server.git
cd zoom-mcp-server
npm install
npm test         # Run tests
npm run build    # Compile TypeScript
npm run dev      # Run with tsx (no build needed)

License

MIT