zoom-mcp/whiteboard

Zoom MCP Whiteboard

Dedicated guidance for Zoom's Whiteboard MCP server.

Endpoints

| Transport | URL | |-----------|-----| | Streamable HTTP (recommended) | https://mcp-us.zoom.us/mcp/whiteboard/streamable | | SSE (fallback) | https://mcp-us.zoom.us/mcp/whiteboard/sse |

Authentication

• User OAuth with Whiteboard scopes is the verified working path for list_whiteboards

and get_a_whiteboard.

• S2S OAuth can reach the Whiteboard MCP gateway and complete tools/list, but tool

execution must be validated separately for your app and Whiteboard scopes.

• Practical rule: start with user OAuth for Whiteboard MCP unless you have already

proven your S2S app can mint and execute with the required Whiteboard scopes.

• The bundled connector expects the token in ZOOM_WHITEBOARD_MCP_ACCESS_TOKEN.

Reference: [references/authentication-and-identifiers.md](references/authentication-and-identifiers.md)

Required Scopes

Whiteboard MCP read scopes:

• whiteboard:read:list_whiteboards
• whiteboard:read:whiteboard

Write-capable Whiteboard metadata advertised by the gateway:

• whiteboard:write:whiteboard

Whiteboard ID Mapping

For Whiteboard MCP, use the identifier from the URL segment after /wb/db/, not the numeric segment after /p/.

Example:

https://us05whiteboard.zoom.us/wb/db/6iktP8hJT3e5qaCuwFuAGg/p/180968285929472
                                     ^^^^^^^^^^^^^^^^^^^^^^   ^^^^^^^^^^^^^^^
                                     whiteboard_id            page/subresource id

Available Tools

The current Whiteboard MCP tool surface is:

• create_a_whiteboard_for_brainstorming
• list_whiteboards
• create_a_whiteboard
• get_a_whiteboard
• create_a_whiteboard_by_script
• update_a_whiteboard_metadata
• create_a_whiteboard_for_meeting_summary
• create_a_whiteboard_for_strategy_analysis

Some MCP clients namespace server tools in the UI. Treat the raw tool names above as authoritative.

Reference: [references/tools.md](references/tools.md)

Read Workflow

• Use a user OAuth token with the Whiteboard read scopes.
• Call list_whiteboards to discover accessible whiteboards and confirm the correct whiteboard_id.
• Call get_a_whiteboard with that whiteboard_id.

Chaining

• Parent MCP skill: [../SKILL.md](../SKILL.md)
• OAuth guidance: [../concepts/oauth-setup.md](../concepts/oauth-setup.md)
• General routing: [../../general/SKILL.md](../../general/SKILL.md)

References

• [references/authentication-and-identifiers.md](references/authentication-and-identifiers.md) - Auth behavior and Whiteboard ID mapping.
• [references/tools.md](references/tools.md) - Whiteboard MCP tool catalog.