# Intervals-icu: A complete TypeScript client for the Intervals.icu API

**URL:** <https://forum.intervals.icu/t/intervals-icu-a-complete-typescript-client-for-the-intervals-icu-api/123768>\
**Category:** External Projects\
**Created:** [4 March 2026 03:30 UTC](https://forum.intervals.icu/t/intervals-icu-a-complete-typescript-client-for-the-intervals-icu-api/123768 "2026-03-04T03:30:07Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![FERNANDO\_PALADINI](https://forum.intervals.icu/user_avatar/forum.intervals.icu/fernando_paladini/32/75631_2.png) [@FERNANDO\_PALADINI](https://forum.intervals.icu/u/FERNANDO_PALADINI)\
**Post date:** [4 March 2026 03:30 UTC](https://forum.intervals.icu/t/intervals-icu-a-complete-typescript-client-for-the-intervals-icu-api/123768/1 "2026-03-04T03:30:07Z")

</div>

Hey everyone!

I’m a developer and amateur runner based in Florianópolis, Brazil. Being part of a vibrant endurance community here, I’ve seen firsthand that for anyone serious about training, **Intervals.icu** is hands-down one of the best platforms for performance analysis.

The problem? I found myself rewriting the same API integration code across multiple personal projects and automation scripts (I’m a big fan of automating everything from GitHub backups to n8n workflows). I finally decided to build a solid, open-source client library to handle the heavy lifting.

The result is `intervals-icu`. You can find the details below:

- **npm:** [https://www.npmjs.com/package/intervals-icu](https://www.npmjs.com/package/intervals-icu)
- **GitHub:** [GitHub - paladini/node-intervals-icu: A lightweight TypeScript / Javascript client library for the Intervals.icu API. · GitHub](https://github.com/paladini/node-intervals-icu)

You can install it via:

```bash
npm install intervals-icu

```

### Real-world usage: Weather Adjusted Pace (WAP)

I’m already dogfooding this library for a new free tool I’m developing: **Weather Adjusted Pace (WAP)**. I’m using `intervals-icu` to seamlessly pull activity data and push adjusted metrics back into the platform. I’ll be sharing more updates on WAP with the community very soon!

### What’s under the hood of the library:

I built this to be the most robust way to interact with Intervals.icu using Node.js/TypeScript:

- **Full Type Safety:** Over 100 methods across 16 services (Activities, Wellness, Workouts, etc.) with strict interfaces. No more guessing what the API response looks like.
- **Dual Auth:** Support for both **API Keys** (personal scripts) and **OAuth 2.0** (for apps acting on behalf of other athletes).
- **Production-Ready Resilience:** It has built-in **exponential backoff** for 429 (rate limit) and 5xx errors. It just works, even when the API is busy.
- **File Handling:** Simplified uploads for `.fit`, `.tcx`, and `.gpx` files.
- **Modern & Lean:** Zero bloat—just `axios`, optimized for Node 18+.

### Why I’m sharing this

I’m a big believer in automating the boring stuff and in the open-source community. I’d love to get your feedback, hear about your use cases, or see your PRs on GitHub.

Let’s build better tools for the endurance community. Happy training!