ClickUp MCP Server

Instructions

Implementation Reference

• src/clickup_mcp/tools.py:1118-1153 (handler)

  The core handler function for the 'log_time' tool. It resolves the task ID using _resolve_task_id, parses the duration string using parse_duration from utils, constructs a time entry payload, determines the workspace ID if needed, and posts it to the ClickUp time_entries API endpoint.

  async def log_time(
      self,
      task_id: str,
      duration: str,
      description: Optional[str] = None,
  ) -> Dict[str, Any]:
      """Log time spent on a task."""
      try:
          # First resolve the task to get the internal ID
          resolved_task = await self._resolve_task_id(task_id)
          duration_ms = parse_duration(duration)
      except ClickUpAPIError as e:
          return {"error": f"Failed to resolve task '{task_id}': {e!s}"}
  
      # Create time entry
      payload = {
          "duration": duration_ms,
          "task_id": resolved_task.id,
      }
      if description:
          payload["description"] = description
  
      workspace_id = self.client.config.default_workspace_id
      if not workspace_id:
          workspaces = await self.client.get_workspaces()
          workspace_id = workspaces[0].id
  
      await self.client._request("POST", f"/team/{workspace_id}/time_entries", json=payload)
  
      return {
          "logged": True,
          "duration": duration,
          "duration_ms": duration_ms,
          "task_id": resolved_task.id,
      }

• src/clickup_mcp/tools.py:380-392 (schema)

  The JSON schema definition for the 'log_time' tool input, defining properties for task_id (string, required), duration (string, e.g. '2h 30m', required), and optional description (string). Provided via get_tool_definitions().

  Tool(
      name="log_time",
      description="Log time spent on a task",
      inputSchema={
          "type": "object",
          "properties": {
              "task_id": {"type": "string", "description": "Task ID"},
              "duration": {"type": "string", "description": "Duration (e.g., '2h 30m')"},
              "description": {"type": "string", "description": "Optional description"},
          },
          "required": ["task_id", "duration"],
      },
  ),

• src/clickup_mcp/tools.py:23-57 (registration)

  Registration of the 'log_time' handler in the ClickUpTools class's _tools dictionary, mapping the tool name to self.log_time method. Used by call_tool to dispatch invocations.

  self._tools: Dict[str, Callable] = {
      "create_task": self.create_task,
      "get_task": self.get_task,
      "update_task": self.update_task,
      "delete_task": self.delete_task,
      "list_tasks": self.list_tasks,
      "search_tasks": self.search_tasks,
      "get_subtasks": self.get_subtasks,
      "get_task_comments": self.get_task_comments,
      "create_task_comment": self.create_task_comment,
      "get_task_status": self.get_task_status,
      "update_task_status": self.update_task_status,
      "get_assignees": self.get_assignees,
      "assign_task": self.assign_task,
      "list_spaces": self.list_spaces,
      "list_folders": self.list_folders,
      "list_lists": self.list_lists,
      "find_list_by_name": self.find_list_by_name,
      # Bulk operations
      "bulk_update_tasks": self.bulk_update_tasks,
      "bulk_move_tasks": self.bulk_move_tasks,
      # Time tracking
      "get_time_tracked": self.get_time_tracked,
      "log_time": self.log_time,
      # Templates
      "create_task_from_template": self.create_task_from_template,
      "create_task_chain": self.create_task_chain,
      # Analytics
      "get_team_workload": self.get_team_workload,
      "get_task_analytics": self.get_task_analytics,
      # User management
      "list_users": self.list_users,
      "get_current_user": self.get_current_user,
      "find_user_by_name": self.find_user_by_name,
  }