getProjectPeople
Retrieve team members assigned to a specific project, with options to filter by role, search names, and organize results.
Instructions
Get all people assigned to a specific project from Teamwork
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | The ID of the project to get people from | |
| userType | No | Filter by user type | |
| searchTerm | No | Filter by name or email | |
| orderMode | No | Order mode | |
| orderBy | No | Order by field | |
| pageSize | No | Number of items per page | |
| page | No | Page number | |
| includeObservers | No | Include project observers |
Implementation Reference
- The main tool handler function. Validates input (especially projectId), calls the teamworkService.getProjectPeople, handles the response by JSON stringifying it, and returns as text content. Includes logging and error handling.export async function handleGetProjectPeople(input: any) { logger.info('=== getProjectPeople tool called ==='); logger.info(`Input parameters: ${JSON.stringify(input || {})}`); try { if (!input.projectId) { logger.error('Missing required parameter: projectId'); return { content: [{ type: "text", text: "Error: Missing required parameter 'projectId'" }] }; } const projectId = parseInt(input.projectId, 10); if (isNaN(projectId)) { logger.error(`Invalid projectId: ${input.projectId}`); return { content: [{ type: "text", text: `Error: Invalid projectId. Must be a number.` }] }; } // Extract projectId from input and create a new params object without it const { projectId: _, ...params } = input; logger.info(`Calling teamworkService.getProjectPeople(${projectId})`); const people = await teamworkService.getProjectPeople(projectId, params); // Debug the response logger.info(`Project people response type: ${typeof people}`); if (people === null || people === undefined) { logger.warn(`No people found for project ID ${projectId} or API returned empty response`); return { content: [{ type: "text", text: `No people found for project ID ${projectId} or API returned empty response.` }] }; } try { const jsonString = JSON.stringify(people, null, 2); logger.info(`Successfully stringified project people response`); logger.info('=== getProjectPeople tool completed successfully ==='); return { content: [{ type: "text", text: jsonString }] }; } catch (jsonError: any) { logger.error(`JSON stringify error: ${jsonError.message}`); return { content: [{ type: "text", text: `Error formatting response: ${jsonError.message}` }] }; } } catch (error: any) { return createErrorResponse(error, 'Retrieving project people'); } }
- The tool schema definition, including name, description, detailed inputSchema with properties like projectId (required), userType, searchTerm, pagination, etc., and annotations.export const getProjectPeopleDefinition = { name: "getProjectPeople", description: "Get all people assigned to a specific project from Teamwork", inputSchema: { type: "object", properties: { projectId: { type: "integer", description: "The ID of the project to get people from" }, userType: { type: "string", enum: ["account", "collaborator", "contact"], description: "Filter by user type" }, searchTerm: { type: "string", description: "Filter by name or email" }, orderMode: { type: "string", enum: ["asc", "desc"], description: "Order mode" }, orderBy: { type: "string", enum: ["name", "namecaseinsensitive", "company"], description: "Order by field" }, pageSize: { type: "integer", description: "Number of items per page" }, page: { type: "integer", description: "Page number" }, includeObservers: { type: "boolean", description: "Include project observers" } }, required: ["projectId"] }, annotations: { title: "Get People in a Project", readOnlyHint: false, destructiveHint: false, openWorldHint: false } };
- src/tools/index.ts:85-85 (registration)Registration of the getProjectPeople tool in the toolPairs array, pairing the definition and handler for inclusion in toolDefinitions and toolHandlersMap.{ definition: getProjectPeople, handler: handleGetProjectPeople },
- Helper service function called by the tool handler. Makes the actual API request to Teamwork's /projects/{projectId}/people.json endpoint and returns the data.export const getProjectPeople = async (projectId: number, params?: Omit<PeopleQueryParams, 'projectId'>) => { try { logger.info(`Fetching people for project ID ${projectId} from Teamwork API`); const api = ensureApiClient(); const response = await api.get(`/projects/${projectId}/people.json`, { params }); logger.info(`Successfully fetched people for project ID ${projectId}`); return response.data; } catch (error: any) { logger.error(`Teamwork API error: ${error.message}`); throw new Error(`Failed to fetch people for project ID ${projectId} from Teamwork API`); } };