list_contacts
Retrieve and filter Zoom contacts by status or page size using the Zoom API MCP Server. Manage active, inactive, or pending contacts with structured input and OAuth 2.0 authentication.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next_page_token | No | Next page token | |
| page_size | No | Number of records returned | |
| status | No | Contact status |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"next_page_token": {
"description": "Next page token",
"type": "string"
},
"page_size": {
"description": "Number of records returned",
"maximum": 300,
"minimum": 1,
"type": "number"
},
"status": {
"description": "Contact status",
"enum": [
"active",
"inactive",
"pending"
],
"type": "string"
}
},
"type": "object"
}
Implementation Reference
- src/tools/contacts.js:13-25 (handler)The handler function for the 'list_contacts' tool. It constructs query parameters for page_size, next_page_token, and status, then makes a GET request to the Zoom API '/contacts' endpoint, handling the response or error.handler: async ({ page_size, next_page_token, status }) => { try { const params = {}; if (page_size) params.page_size = page_size; if (next_page_token) params.next_page_token = next_page_token; if (status) params.status = status; const response = await zoomApi.get('/contacts', { params }); return handleApiResponse(response); } catch (error) { return handleApiError(error); } }
- src/tools/contacts.js:8-12 (schema)Zod schema defining the input parameters for the 'list_contacts' tool: optional page_size (1-300), next_page_token, and status (active/inactive/pending).schema: { page_size: z.number().min(1).max(300).optional().describe("Number of records returned"), next_page_token: z.string().optional().describe("Next page token"), status: z.enum(["active", "inactive", "pending"]).optional().describe("Contact status") },
- src/server.js:52-52 (registration)Registration of the contactsTools array to the MCP server via registerTools, which includes the 'list_contacts' tool along with others.registerTools(contactsTools);