list-meetings
Retrieve and filter your recorded meetings from Zoom, Google Meet, and MS Teams by date, status, or participation to find specific sessions quickly.
Instructions
List all meetings based on the filters provided. You can filter by date, status, and more. Those meetings are the sames you have access to in the TLDV app.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | ||
| page | No | ||
| limit | No | ||
| from | No | ||
| to | No | ||
| onlyParticipated | No | ||
| meetingType | No |
Implementation Reference
- src/index.ts:82-92 (handler)The MCP tool handler registration for 'list-meetings'. This is the function that executes when the tool is called, fetching meetings via TldvApi and returning the JSON-stringified result.server.tool( tools["list-meetings"].name, tools["list-meetings"].description, tools["list-meetings"].inputSchema.shape, async (input) => { const meetings = await tldvApi.getMeetings(input); return { content: [{ type: "text", text: JSON.stringify(meetings) }] }; } );
- src/api/schemas.ts:123-136 (schema)Zod schema defining the input parameters for the list-meetings tool (GetMeetingsParamsSchema), used for validation.export const GetMeetingsParamsSchema = z.object({ query: z.string().optional(), // search query page: z.number().int().positive().optional(), // page number limit: z.number().int().positive().optional().default(50), // number of results per page from: z.string().datetime().optional(), // start date to: z.string().datetime().optional(), // end date onlyParticipated: z.boolean().optional(), // only return meetings where the user participated // meeting type. internal is default. // This is used to filter meetings by type. Type is determined by comparing the organizer's email with the invitees' emails. // If the organizer's domain is different from at least one of the invitees' domains, the meeting is external. // Otherwise, the meeting is internal. meetingType: z.enum(['internal', 'external']).optional(), });
- src/index.ts:30-34 (registration)Tool definition object for 'list-meetings' used in MCP server capabilities declaration."list-meetings": { name: "list-meetings", description: "List all meetings based on the filters provided. You can filter by date, status, and more. Those meetings are the sames you have access to in the TLDV app.", inputSchema: GetMeetingsParamsSchema, },
- src/api/tldv-api.ts:172-185 (helper)TldvApi.getMeetings method: validates input, constructs query parameters, and makes the API request to fetch meetings list.async getMeetings(params: GetMeetingsParams = {}): Promise<TldvResponse<GetMeetingsResponse>> { const validatedParams = GetMeetingsParamsSchema.parse(params); const queryParams = new URLSearchParams(); if (validatedParams.query) queryParams.append('query', validatedParams.query); if (validatedParams.page) queryParams.append('page', validatedParams.page.toString()); if (validatedParams.limit) queryParams.append('limit', validatedParams.limit.toString()); if (validatedParams.from) queryParams.append('from', validatedParams.from); if (validatedParams.to) queryParams.append('to', validatedParams.to); if (validatedParams.onlyParticipated !== undefined) queryParams.append('onlyParticipated', validatedParams.onlyParticipated.toString()); if (validatedParams.meetingType) queryParams.append('meetingType', validatedParams.meetingType); return this.request<GetMeetingsResponse>(`/meetings?${queryParams}`); }