Teamwork MCP

Instructions

Implementation Reference

• src/tools/tasks/getTaskById.ts:33-54 (handler)

  MCP tool handler function that validates input, calls the teamwork service to fetch the task, formats the response as text content, and handles errors.

  export async function handleGetTaskById(input: any) {
    logger.info('Calling teamworkService.getTaskById()');
    logger.info(`Task ID: ${input?.taskId}`);
    
    try {
      const taskId = String(input?.taskId);
      if (!taskId) {
        throw new Error("Task ID is required");
      }
      
      const task = await teamworkService.getTaskById(taskId);
      
      return {
        content: [{
          type: "text",
          text: JSON.stringify(task, null, 2)
        }]
      };
    } catch (error: any) {
      return createErrorResponse(error, 'Retrieving task');
    }
  } 

• src/tools/tasks/getTaskById.ts:11-30 (schema)

  Tool definition including name, description, input schema (taskId as integer), and annotations for the MCP tool.

  export const getTaskByIdDefinition = {
    name: "getTaskById",
    description: "Get a specific task by ID from Teamwork",
    inputSchema: {
      type: "object",
      properties: {
        taskId: {
          type: "integer",
          description: "The ID of the task to retrieve"
        }
      },
      required: ["taskId"]
    },
    annotations: {
      title: "Get a Task by its ID",
      readOnlyHint: false,
      destructiveHint: false,
      openWorldHint: false
    }
  };

• src/tools/index.ts:73-73 (registration)

  Registration of the getTaskById tool in the toolPairs array, mapping definition to handler for MCP tool registry.

  { definition: getTaskById, handler: handleGetTaskById },

• src/services/tasks/getTaskById.ts:9-18 (helper)

  Service function that performs the actual API call to Teamwork to retrieve a task by ID, used by the tool handler.

  export const getTaskById = async (taskId: string) => {
    try {
      const api = ensureApiClient();
      const response = await api.get(`/tasks/${taskId}.json`);
      return response.data;
    } catch (error: any) {
      logger.error(`Error fetching task ${taskId}: ${error.message}`);
      throw new Error(`Failed to fetch task ${taskId}`);
    }
  };