Auckland Airport: There is no Oneroa airport. Take Auckland public transport into the CBD, then walk to the downtown ferry terminal/Pier 2 for the Fullers ferry to Mātiatia. Allow roughly 1¼–1¾ hours airport-to-ferry-terminal depending on the connection, then 40 minutes on the ferry; budget about NZ$5–10 for the airport/CBD public-transport leg and NZ$59 return for the ferry. A taxi all the way to the ferry is not the clever spend unless you are carrying awkward luggage or arriving very late.
Downtown Auckland Ferry Terminal (Pier 2): This is the real gateway to Oneroa. Fullers runs frequent passenger ferries to Mātiatia, about 40 minutes; the published adult return fare is about NZ$59, with cheaper off-peak options. From Mātiatia, take a Waiheke bus into Oneroa—roughly 10 minutes and about NZ$3—or a short taxi ride. In summer weekends and holiday peaks, use a reservable ferry fare if timing matters: the standard queue can be grim.
Half Moon Bay Ferry Terminal: SeaLink’s vehicle/passenger ferry goes to Kennedy Point in 45–60 minutes. It can make sense if you already have a car on Auckland’s eastern side, but it is not the best arrival route for car-free Oneroa visitors: Kennedy Point is away from the main bus network, so add a pre-arranged transfer or taxi. The quoted adult return is about NZ$36.50, before onward transport.