Connecting Zoom (setup checklist)

This checklist walks you through connecting Zoom to Harriet, giving the assistant access to meetings, transcripts, and cloud recordings.

You'll need: a Zoom account that can create Marketplace apps, and access to Harriet's Company settings → Integrations.

How access works (before you start)

Installing this connector registers an OAuth app — Harriet does not access Zoom as the admin. Each user connects their own Zoom account under Profile → Integrations, and Harriet only sees the meetings and recordings that user can access.

Step 1 — Create a Zoom app

1. Go to marketplace.zoom.us and sign in.
2. Click Develop (top right) → Build App.
3. Select General App and click Create; name it (e.g. Harriet).

Step 2 — Add the redirect URLs

In the app's Basic Information, add both OAuth redirect URLs:

https://hrharriet.com/bots/integrations/mcp/oauth/callback/
https://harriethq.com/bots/integrations/mcp/oauth/callback/

The match must be exact, including the trailing slash.

Step 3 — Add the scopes

Use the MCP scopes below, not the regular REST API scopes (recording:read:…, meeting:read:list_meetings, …). Zoom's MCP server checks its own scope set — with REST scopes, users connect fine but every action fails with "Invalid access token, does not contain scopes: […]".

In the left sidebar, open Scopes → Add Scopes and add:

Meetings & search

meeting:read:search
meeting:read:assets

Recordings & transcripts

cloud_recording:read:list_user_recordings
cloud_recording:read:content

Cross-product search (optional — requires the Zoom AI Companion add-on; skip if your plan doesn't include it, this only disables search across Meetings/Chat/Docs)

ai_companion:read:search

Zoom Docs (optional — only if you want Harriet to read/create Zoom Docs)

docs:read:export
docs:write:import

Step 4 — Share the app with your colleagues

An unpublished Zoom app can only be authorized by its owner — colleagues hit "Application not found — it may have been deleted or you don't have permission to view it". To fix this:

• In the app, open the Local Test page, click Add App Now to install it on your own account first, then use the page's sharing option to share it with internal users — this allows everyone on your Zoom account to authorize.
• Sharing with people outside your Zoom account requires a Zoom-approved publishable URL or publishing the app to the Marketplace.

Step 5 — Copy the credentials

In the left sidebar, open App Credentials, copy the Client ID, click Show next to the Client Secret and copy it too.

Step 6 — Install in Harriet and finish

1. In Harriet, go to Connectors → Browse catalog, find Zoom, and click Install.
2. Paste the Client ID and Client Secret, click Review, then confirm.
3. Use Sync tools to load the Zoom actions and enable the tools you want.
4. Attach the connector to a skill and assign the skill.
5. Each user connects their own Zoom account under Profile → Integrations and clicks Allow on Zoom's consent screen.
6. Verify: ask Harriet something like "list my Zoom recordings from this week."

Troubleshooting

Symptom	Most likely cause
"Application not found" when a colleague tries to connect	The app is unpublished and hasn't been shared — use Local Test to share it with internal users (Step 4).
"Invalid access token, does not contain scopes: […]" on every action	The app has REST API scopes instead of the MCP scopes (Step 3). Add the MCP scopes, then have users disconnect and reconnect under Profile → Integrations.
OAuth error at Zoom sign-in	Redirect URL missing or inexact (Step 2), or Client ID/secret mismatch (Step 5).
Connected but recordings/meetings missing	Scopes missing on the Zoom app (Step 3) — users must reconnect after scope changes.
A user sees different meetings than expected	Expected — Harriet sees exactly what that user's Zoom account can access.

See also How to create an MCP connector (Company settings).