googlarz/suunto-mcp

**Ask Claude anything about your training.** Suunto MCP connects your Suunto watch data to Claude so you can just talk to your data instead of clicking through dashboards.
> *Built by a Suunto user who wanted to ask "how was my last long run?" and get a real answer with numbers — and to feed live training data into a personal AI coach.*
> 🏃 **For regular Suunto users:** Suunto's API docs say access is for commercial partners only — **that's not the full picture.** Private users get access too. It just takes **3–4 weeks** for approval after you apply. Submit, wait, enjoy. Don't let that disclaimer stop you. ✅
---
What you can do
Once it's set up, just ask:
- *"How many kilometers did I run this month?"*
- *"Compare my last three long runs — has my heart-rate drift improved?"*
- *"How did my heart rate hold up set by set in last night's gym session?"*
- *"What's my average resting HR trend over the last two weeks?"*
- *"Summarize my training week in the style of a coaching report."*
- *"I've been feeling off — how do my recovery scores compare to last month?"*
- *"Find every workout where I averaged above 160 bpm."*
- *"Which of my runs this year had the most elevation?"*
Claude figures out what data to pull. You just ask.
It's not just read-only either — Claude can push things to your watch too:
- *"Plan tonight's gym session and send it to my watch."*
- *"Upload yesterday's Garmin export as a Suunto workout."*
- *"Export my last route as GPX so I can share it."*
See What you can push to your watch below.
---
🤖 Don't want to do this yourself? Let Claude Code install it
If you already have Claude Code, you don't need to run a single terminal command. Just open it and say:
> *"Please install and set up suunto-mcp from https://github.com/googlarz/suunto-mcp"*
Claude Code will clone the repo, run all the install commands, and add everything to your Claude Desktop config — on its own. That's exactly how this project's author set it up: no manual terminal work.
Three things stay yours no matter what, by design, not because of missing tooling:
1. **Creating the apizone.suunto.com account** — Claude can't create accounts on your behalf.
2. **The apizone web form** (naming your app, revealing your subscription key) — it's your account session; Claude tells you exactly where to click, but can't click there for you.
3. **Clicking "Authorize"** during login — that's OAuth working as intended. An app that could approve its own access wouldn't be secure.
Claude will tell you exactly what to do and when for each of these.
**If you want to do it manually, keep reading.**
---
What you need
Before starting, make sure you have:
- [ ] **A Suunto watch** synced to the Suunto app (any modern model — Race, Vertical, 9 Peak, 5 Peak, Ocean, etc.)
- [ ] **Claude Desktop** (or another MCP-compatible AI app)
- [ ] **Node.js** — free, download here, choose the "LTS" version
- [ ] **Git** — free, download here
- [ ] **~5 min to submit** + 3–4 week wait for Suunto approval + ~15 min to install
Once it's done, you never redo it.
---
Setup
> **Prefer one guided walkthrough with a pacing choice up front** (fast path
> vs. explained-step-by-step) and a proper explanation of how syncing works?
> See GETTING_STARTED.md. What follows here is the same
> steps in reference form.
The setup has three parts:
1. **Register with Suunto's developer portal** — tells Suunto your app is allowed to read your data
2. **Install and configure** — gets the software running on your computer
3. **Connect to Claude** — lets the AI find and use it
---
Part 1: Register with Suunto's developer portal (~5 min to submit, then wait 3–4 weeks)
Suunto has a free developer portal called **apizone** where you register apps that can access your data. You'll create an account, subscribe to the data plan, and register a small "app" — don't worry, there's nothing to build, it's just a name and a password you make up.
Step 1: Create your apizone account
Go to apizone.suunto.com and sign up or sign in.
**Use the same email you use for the Suunto app.** If you have a Sports Tracker account, that works too — it's the same login system.
Step 2: Subscribe to the Developer API
After signing in, follow the How to start guide — it walks you through subscribing to the **Developer API**. This is free and gives you access to your workout history.
> **Heads up:** Suunto's website states that API access is only for commercial partners — ignore that. Private users do get access, it just takes **3–4 weeks** for the subscription to be approved. Submit it and wait. It will come through.