get_user_project_tasks

Retrieve all tasks for a specific project assigned to you using the project ID. This tool helps you view and manage your project workload within the MoCo time tracking system.

Instructions

Get all tasks for a specific assigned project by project ID. Only works for projects assigned to the current user.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`projectId`	Yes	Project ID to retrieve tasks for

Implementation Reference

src/tools/userProjectsTools.ts:72-99 (handler)

The main handler function for the get_user_project_tasks tool. Validates projectId, fetches tasks using MocoApiService, handles empty results and errors, and formats output using formatProjectTasks.

handler: async (params: z.infer<typeof GetProjectTasksSchema>): Promise<string> => {
  const { projectId } = params;

  if (!Number.isInteger(projectId) || projectId <= 0) {
    return createValidationErrorMessage({
      field: 'projectId',
      value: projectId,
      reason: 'invalid_project_id'
    });
  }

  try {
    const apiService = new MocoApiService();
    const tasks = await apiService.getProjectTasks(projectId);

    if (tasks.length === 0) {
      return createEmptyResultMessage({ 
        type: 'tasks',
        projectId 
      });
    }

    return formatProjectTasks(tasks, projectId);

  } catch (error) {
    return `Error retrieving tasks for project ${projectId}: ${error instanceof Error ? error.message : 'Unknown error'}`;
  }
}

src/tools/userProjectsTools.ts:18-20 (schema)
Zod schema defining the input for the tool: requires a positive projectId number.
```
const GetProjectTasksSchema = z.object({
  projectId: z.number().positive().describe('Project ID to retrieve tasks for')
});
```

src/index.ts:34-42 (registration)

The tool is imported and registered in the AVAILABLE_TOOLS array, which is used by the MCP server for tool listing and execution dispatching.

const AVAILABLE_TOOLS = [
  getActivitiesTool,
  getUserProjectsTool,
  getUserProjectTasksTool,
  getUserHolidaysTool,
  getUserPresencesTool,
  getUserSickDaysTool,
  getPublicHolidaysTool
];

src/tools/userProjectsTools.ts:169-183 (helper)

Helper function to format the list of tasks into a readable string output, used by the tool handler.

function formatProjectTasks(tasks: Task[], projectId: number): string {
  const lines: string[] = [];
  
  lines.push(`Tasks for project ${projectId} (${tasks.length} found):\n`);

  tasks.forEach(task => {
    lines.push(`ID: ${task.id}`);
    lines.push(`Name: ${task.name}`);
    lines.push(`Status: ${task.active ? 'Active' : 'Inactive'}`);
    lines.push(`Billable: ${task.billable ? 'Yes' : 'No'}`);
    lines.push(''); // Empty line between tasks
  });

  return lines.join('\\n');
}

MoCo MCP Server