Skip to main content
Glama
FujitsuPolycom

Zoom Phone MCP Server

by FujitsuPolycom
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Zoom Phone MCP Server

A standalone Model Context Protocol server for Zoom Phone.

What This Does

Zoom Phone's REST API has 200+ endpoints for managing telephony: auto receptionists, IVR menus, call queues, voicemail, greetings, audio library, call routing, devices, SMS, and more. Zoom's official MCP servers only handle Meetings, Chat, Whiteboard, Tasks, and Canvas — not Phone.

Related MCP server: Zoom API MCP Server

Features

Category

Tools

Highlights

Auto Receptionists

17

List, create, update, delete, IVR menu tree CRUD, call handling (business/closed/holiday hours), policies, settings, phone number assignment

Call Queues

22

Full CRUD, member management, call handling per hour type, settings (greetings/prompts), policies, recordings, analytics, custom groups

Audio Library

6

List, get, create (TTS), batch create, update, delete greetings/prompts

Phone Users

10

List, get, update, call handling, policies, settings, phone number assignment

Phone Numbers

5

List (assigned/unassigned/all), get, update, unassign, calling plans

Voicemails

7

Account/user voicemails, details, delete, read status, download

Call History

6

Account/user call history, sync, delete entries, client codes

Devices

8

List, get, add, update, delete, reboot deskphones, assign extensions, sync

Sites

7

List, get, create, update, delete, settings per type

Common Areas

7

List, get, create, update, delete, call handling per hour type

Routing Rules

5

List, get, create, update, delete directory backup routing rules

Shared Line Groups

8

Full CRUD, member management, phone number assignment

SMS & Recordings

7

Send SMS, list sessions, get messages, list/download recordings

Reports

4

Call charges, fax charges, operation logs, SMS charges

Total: 117 tools across the Zoom Phone API.

Quick Start

Prerequisites

Option 1: Docker (recommended)

git clone https://github.com/fujitsupolycom/zoom-phone-mcp.git
cd zoom-phone-mcp

# Create .env from template
cp .env.example .env
# Edit .env with your Zoom credentials

docker compose up -d

Server runs on http://localhost:8767/mcp

Option 2: pip install

pip install zoom-phone-mcp

export ZOOM_ACCOUNT_ID="your_account_id"
export ZOOM_CLIENT_ID="your_client_id"
export ZOOM_CLIENT_SECRET="your_client_secret"

python -m zoom_phone_mcp.server

Option 3: Development

git clone https://github.com/fujitsupolycom/zoom-phone-mcp.git
cd zoom-phone-mcp
pip install -e ".[dev]"
cp .env.example .env  # fill in credentials
python -m zoom_phone_mcp.server

Connecting Your MCP Client

Claude Desktop / Cursor

Add to your MCP client config:

{
  "mcpServers": {
    "zoom-phone": {
      "url": "http://localhost:8767/mcp"
    }
  }
}

Hermes Agent

hermes mcp add zoom-phone --url http://localhost:8767/mcp
hermes mcp test zoom-phone

Authentication

This server uses Zoom's Server-to-Server OAuth flow (no user interaction needed). You need:

  1. A Server-to-Server OAuth app on the Zoom App Marketplace

  2. The app's Account ID, Client ID, and Client Secret

  3. Phone scopes assigned to the app (see below)

The server automatically fetches and refreshes access tokens (1-hour expiry).

Scope Profiles

Zoom supports granular OAuth scopes for Phone. Server-to-Server apps use the :admin suffix. Choose a profile based on what you need:

Full Admin (all tools work)

phone:read:admin
phone:write:admin

These two legacy scopes grant read/write access to most of the Phone API. However, Zoom requires additional granular scopes for certain call handling and settings sub-resources, even when the legacy admin scopes are present. To ensure every tool works, add these granular scopes as well:

phone:read:auto_receptionist_call_handling_setting:admin
phone:read:auto_receptionist_setting:admin
phone:read:call_queue_call_handling_setting:admin
phone:read:call_queue_setting:admin
phone:read:call_queue_policy:admin
phone:read:call_queue_custom_group:admin
phone:read:user_call_handling_setting:admin
phone:read:common_area_call_handling_setting:admin

Without these, list/get calls for auto receptionist settings, call queue settings/policies/custom groups, user call handling, and common area call handling will return Insicient scope errors. All other tools work with just the two legacy scopes.

Read-Only (all list/get tools, no create/update/delete)

Add only the phone:read:*:admin granular scopes for resources you want to query. Full list:

phone:read:list_auto_receptionists:admin
phone:read:auto_receptionist:admin
phone:read:auto_receptionist_setting:admin
phone:read:auto_receptionist_call_handling_setting:admin
phone:read:auto_receptionist_policy:admin
phone:read:auto_receptionist_ivr:admin
phone:read:list_call_queues:admin
phone:read:call_queue:admin
phone:read:call_queue_setting:admin
phone:read:call_queue_call_handling_setting:admin
phone:read:call_queue_policy:admin
phone:read:list_call_queue_members:admin
phone:read:list_call_queue_recordings:admin
phone:read:call_queue_custom_group:admin
phone:read:list_audios:admin
phone:read:audio:admin
phone:read:list_users:admin
phone:read:user:admin
phone:read:user_call_handling_setting:admin
phone:read:user_policy:admin
phone:read:user_setting:admin
phone:read:list_numbers:admin
phone:read:numbers:admin
phone:read:list_calling_plans:admin
phone:read:list_voicemails:admin
phone:read:voicemail:admin
phone:read:list_call_logs:admin
phone:read:call_log:admin
phone:read:list_devices:admin
phone:read:device:admin
phone:read:list_sites:admin
phone:read:site:admin
phone:read:site_setting:admin
phone:read:common_area:admin
phone:read:list_common_area_settings:admin
phone:read:common_area_call_handling_setting:admin
phone:read:list_routing_rules:admin
phone:read:routing_rule:admin
phone:read:list_shared_line_groups:admin
phone:read:shared_line_group:admin
phone:read:shared_line_group_setting:admin
phone:read:shared_line_group_call_handling_setting:admin
phone:read:shared_line_group_policy:admin
phone:read:list_sms_sessions:admin
phone:read:sms_session:admin
phone:read:sms_message:admin
phone:read:call_charges:admin
phone:read:fax_charges:admin
phone:read:operation_logs:admin
phone:read:sms_charges:admin

Call Routing Admin (manage call flow, read-only on users/devices/billing)

Write access to auto receptionists, call queues, audio library, common areas, routing rules, and shared line groups. Read-only on everything else. Useful for a team that manages IVR and call routing but shouldn't touch user provisioning or billing.

# Read + write: call routing resources
phone:read:auto_receptionist:admin
phone:write:auto_receptionist:admin
phone:read:auto_receptionist_setting:admin
phone:write:auto_receptionist_setting:admin
phone:delete:auto_receptionist_setting:admin
phone:read:auto_receptionist_call_handling_setting:admin
phone:update:auto_receptionist_call_handling_setting:admin
phone:read:auto_receptionist_policy:admin
phone:write:auto_receptionist_policy:admin
phone:update:auto_receptionist_policy:admin
phone:read:auto_receptionist_ivr:admin
phone:update:auto_receptionist_ivr:admin
phone:write:auto_receptionist_number:admin
phone:delete:auto_receptionist_number:admin
phone:read:list_auto_receptionists:admin

phone:read:list_call_queues:admin
phone:read:call_queue:admin
phone:update:call_queue:admin
phone:write:call_queue:admin
phone:delete:call_queue:admin
phone:read:call_queue_setting:admin
phone:write:call_queue_setting:admin
phone:update:call_queue_setting:admin
phone:delete:call_queue_setting:admin
phone:read:call_queue_call_handling_setting:admin
phone:update:call_queue_call_handling_setting:admin
phone:read:call_queue_policy:admin
phone:write:call_queue_policy:admin
phone:update:call_queue_policy:admin
phone:read:list_call_queue_members:admin
phone:write:call_queue_member:admin
phone:delete:call_queue_member:admin
phone:read:list_call_queue_recordings:admin
phone:read:call_queue_custom_group:admin
phone:write:call_queue_custom_group:admin
phone:update:call_queue_custom_group:admin
phone:delete:call_queue_custom_group:admin
phone:write:call_queue_number:admin
phone:delete:call_queue_number:admin

phone:read:list_audios:admin
phone:read:audio:admin
phone:write:audio:admin
phone:update:audio:admin
phone:delete:audio:admin
phone:write:batch_audios:admin

phone:read:common_area:admin
phone:write:common_area:admin
phone:update:common_area:admin
phone:delete:common_area:admin
phone:read:list_common_area_settings:admin
phone:read:common_area_call_handling_setting:admin
phone:update:common_area_call_handling_setting:admin

phone:read:list_routing_rules:admin
phone:read:routing_rule:admin
phone:write:routing_rule:admin
phone:update:routing_rule:admin
phone:delete:routing_rule:admin

phone:read:list_shared_line_groups:admin
phone:read:shared_line_group:admin
phone:write:shared_line_group:admin
phone:update:shared_line_group:admin
phone:delete:shared_line_group:admin
phone:read:shared_line_group_setting:admin
phone:write:shared_line_group_setting:admin
phone:update:shared_line_group_setting:admin
phone:delete:shared_line_group_setting:admin
phone:read:shared_line_group_call_handling_setting:admin
phone:update:shared_line_group_call_handling_setting:admin
phone:read:shared_line_group_policy:admin
phone:write:shared_line_group_policy:admin
phone:update:shared_line_group_policy:admin
phone:delete:shared_line_group_policy:admin
phone:write:shared_line_member:admin
phone:delete:shared_line_member:admin
phone:write:shared_line_group_number:admin
phone:delete:shared_line_group_number:admin

# Read-only: everything else
phone:read:list_users:admin
phone:read:user:admin
phone:read:user_call_handling_setting:admin
phone:read:user_policy:admin
phone:read:user_setting:admin
phone:read:list_numbers:admin
phone:read:numbers:admin
phone:read:list_calling_plans:admin
phone:read:list_voicemails:admin
phone:read:voicemail:admin
phone:read:list_call_logs:admin
phone:read:call_log:admin
phone:read:list_devices:admin
phone:read:device:admin
phone:read:list_sites:admin
phone:read:site:admin
phone:read:site_setting:admin
phone:read:call_charges:admin
phone:read:fax_charges:admin
phone:read:operation_logs:admin
phone:read:sms_charges:admin

Tool Examples

List auto receptionists

list_auto_receptionists(page_size=100)

Get IVR menu tree

get_auto_receptionist_ivr(auto_receptionist_id="abc123")

Update IVR routing

update_auto_receptionist_ivr(
  auto_receptionist_id="abc123",
  ivr_settings={"key_presses": [{"digit": "1", "action_type": "route_to_user", "target": "user@example.com"}]}
)

List call queues

list_call_queues()

Update holiday hours routing for a call queue

update_queue_call_handling(
  call_queue_id="abc123",
  hour_type="holiday_hours",
  call_handling_settings={"call_handling": [{"action_type": "disconnect"}]}
)

Create a TTS greeting

add_audio_item(
  user_id="me@company.com",
  name="Holiday Greeting",
  text="Thank you for calling. We are closed for the holiday.",
  voice_accent="Joanna-Female",
  voice_language="en-US"
)

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest -v

# Run with hot reload
python -m zoom_phone_mcp.server

Tech Stack

  • MCP SDK — FastMCP with Streamable HTTP transport

  • httpx — async HTTP client for Zoom API

  • uvicorn — ASGI server

  • Pydantic — data validation

License

MIT — see LICENSE

Contributing

PRs welcome.

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Zoom API MCP Server

    qingyun-wu
    F
    license
    -
    quality
    D
    maintenance
    An MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the Zoom API through natural language commands, auto-generated using AG2's MCP builder.

  • Zoom API MCP Server

    allisonwhilden
    -
    license
    -
    quality
    -
    maintenance
    An MCP Server that enables interaction with Zoom's API through the Multi-Agent Conversation Protocol, allowing users to access and control Zoom's functionality via natural language commands.

  • Zoom MCP Server

    qingyun-ag2
    F
    license
    -
    quality
    D
    maintenance
    An MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the Zoom API through natural language, auto-generated using AG2's MCP builder.

View all related MCP servers

Related MCP Connectors

  • omnidim-mcp-server

    Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.

  • inflow

    MCP Server for agents to onboard, pay, and provision services autonomously with InFlow

  • Wavix

    Hosted MCP server for the Wavix telecom platform: SMS, voice, 2FA, SIP, numbers, 10DLC, CDRs.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FujitsuPolycom/zoom-phone-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server