Log inSubmit server
Suunto MCP logo

Suunto MCP

by googlarz

Connects Suunto watch data to AI clients for workout analysis, recovery tracking, FIT decoding, and GPX export.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Suunto MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "googlarz-suunto-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "suunto-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

googlarz/suunto-mcp connects Suunto watch data to an MCP-compatible AI client through Suunto's official apizone API. It supports OAuth2 pairing, workout and time-series queries, FIT-file decoding, GPX export, and access to activity, sleep, recovery, and HRV data. Resources provide today's recovery information and a weekly training summary as ambient context. Reach for it when you want conversational analysis of Suunto training data or need to send workouts and routes back to the watch.

Use cases

  • Compare recent long runs and heart-rate drift
  • Review weekly training alongside recovery and sleep
  • Find workouts that exceed a heart-rate threshold
  • Decode FIT files and export routes as GPX
  • Send planned sessions to a Suunto watch

Key features

  • OAuth2 pairing with Suunto apizone
  • Workout and time-series access
  • FIT-file decoding
  • GPX route export
  • Activity, sleep, recovery, and HRV data
  • Recovery and weekly training MCP resources

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · suunto-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars35Stargazers on the source repository.
npm downloads1.2kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Directory activity12 viewsConfig copies, upvotes, and views on AllMCPs.

How Suunto MCP works

What googlarz/suunto-mcp does

googlarz/suunto-mcp exposes Suunto data through the Model Context Protocol, allowing an AI client to retrieve and interpret information from a connected Suunto account. Its primary focus is training analysis: workout history, detailed time-series samples, heart-rate patterns, distance, elevation, and related metrics can be queried conversationally.

The server also covers data beyond individual workouts. Depending on the APIs enabled for the Suunto account, it can work with 24/7 activity, sleep, recovery, and HRV information. MCP resources provide a current recovery view for today and a summary of the training week, so an AI client can use those details as context without a separate request.

Data can also move in the other direction. The project supports sending planned sessions or uploaded workout data to a Suunto watch, along with exporting routes as GPX files. FIT files can be decoded for use in workout-related workflows.

How it works

The connection uses Suunto's official apizone API. Authentication is handled through OAuth2: the user registers an application with Suunto, configures a redirect URI, and authorizes access during login. After pairing, the MCP client can request the available Suunto data and present the results through its normal tool interface.

A Suunto watch must first be synced with the Suunto app. The server does not replace that synchronization step; it reads the account data made available through Suunto's APIs. Asking questions such as comparing long runs, reviewing resting-heart-rate trends, or finding workouts above a heart-rate threshold lets the AI client decide which data to retrieve.

Setup and configuration

Setup requires a Suunto apizone account, an approved Developer API subscription, an OAuth application, and the application's credentials. The setup process uses:

  • A Suunto or Sports Tracker account with the same email used by the Suunto app
  • A registered OAuth application with a client ID and client secret
  • The exact redirect URI http://localhost:8421/callback
  • The subscription's primary key
  • Node.js and Git
  • An MCP-compatible AI client, such as Claude Desktop

The project can be installed by cloning the repository, running npm install, and building with npm run build. Credentials are placed in a local .env file based on the project's example file. OAuth approval is completed interactively by the account holder.

Suunto approval for API access may take three to four weeks. The Developer API provides workout access; separate Sleep, Recovery, or Daily Activity subscriptions may be needed for those corresponding data sets.

Tools and capabilities

The available functionality includes:

  • Listing and retrieving Suunto workouts
  • Reading workout time-series samples
  • Decoding FIT files
  • Exporting routes as GPX
  • Accessing 24/7 activity data
  • Reading sleep, recovery, and HRV information
  • Exposing today's recovery as an MCP resource
  • Exposing a weekly training summary as an MCP resource
  • Sending planned sessions or workout data to a Suunto watch

These capabilities suit conversational coaching workflows, historical comparisons, route sharing, and analysis that combines workouts with recovery or sleep context.

Limitations and notes

Access depends on Suunto apizone approval and the subscriptions enabled for the account. A watch must be synced to the Suunto app before its data can be available through the API. OAuth authorization, account creation, application registration, and credential handling remain user-controlled steps. The redirect URI must match the registered value exactly, and the client secret should be kept private.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Suunto MCP

googlarz/suunto-mcp is an MCP server that connects AI clients to Suunto watch data through the official apizone API. Its main tools cover workout listing and retrieval, time-series samples, FIT-file decoding, GPX export, and activity, sleep, recovery, and HRV data access for conversational training analysis.

Install it by cloning the repository, running `npm install`, and executing `npm run build`. Create a local `.env` file from the example, add the Suunto credentials, then connect the built server to an MCP-compatible client such as Claude Desktop.

Connect it by registering an OAuth application in Suunto's apizone portal, obtaining API approval and a subscription key, then completing OAuth authorization with the redirect URI `http://localhost:8421/callback`. The watch must already be synced to the Suunto app.

Yes, it supports sleep, recovery, HRV, and 24/7 activity data when the corresponding Suunto API access is enabled. The server also exposes today's recovery and the week's training summary as MCP resources.

Yes, it can export routes as GPX files. It also supports FIT-file decoding and can send planned sessions or workout data to a Suunto watch.

Related MCP servers

All in Sports All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSuunto MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/googlarz-suunto-mcp?style=directory)](https://allmcps.com/mcp/googlarz-suunto-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/googlarz-suunto-mcp"><img src="https://allmcps.com/api/badge/googlarz-suunto-mcp?style=directory" alt="Suunto MCP on AllMCPs" /></a>