# Kaiord

> Kaiord is an open-source MCP server for files and documents. Convert, validate and inspect FIT, TCX, ZWO and Garmin workout files from an agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://kaiord.com/docs/mcp/tools
- **Repository:** https://github.com/pablo-albaladejo/kaiord
- **MCP Registry name:** io.github.pablo-albaladejo/kaiord
- **Categories:** files and documents, health and science
- **Listing updated:** 2026-11-14

## About

The server's job is fitness file formats. It converts between FIT, TCX, ZWO (Zwift), Garmin Connect workout JSON (GCN) and Kaiord's own JSON format, KRD, and can also validate, inspect, diff and extract structured workouts. GCN output stores power in watts, so a workout with percent-of-FTP targets needs the athlete's FTP supplied, otherwise the tool fails with a missing-ftp error.

There are two ways to run it. Locally, the npm package runs over stdio and additionally has Garmin Connect tools for pushing a workout after login, plus health tools. A hosted, stateless endpoint needs no install or account but is a subset: eight tools, inline content only with FIT as base64, structured workouts only, a 65,536-byte request limit, and ZWO checked for well-formedness without XSD validation. The hosted endpoint stores and logs nothing.

Kaiord also ships a TypeScript library, a CLI and a browser workout editor, and the README describes conversions as running on your own machine with no Kaiord backend. It lists one known gap: the TrainingPeaks TSS duration type is not yet implemented in the FIT converter.

## Features

- **Format conversion:** FIT, TCX, ZWO, GCN and KRD in either direction.
- **Round-trip validation:** Checks that a conversion survives a trip back.
- **Inspect and diff:** Summarise a file or compare two field by field with tolerances.
- **Workout extraction:** Pulls steps, targets and durations into JSON.
- **Hosted endpoint:** A no-install, no-account remote subset.
- **Garmin Connect push:** Local server only: send a workout to Garmin Connect after login.

## Good for

- Turn a Zwift workout into a Garmin workout
- Check that a FIT file converted without losing data
- Compare two versions of a workout file
- Summarise a workout's steps and targets for an athlete
- Push a structured workout to Garmin Connect

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http kaiord https://kaiord.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://kaiord.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kaiord": {
      "url": "https://kaiord.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kaiord": {
      "type": "http",
      "url": "https://kaiord.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kaiord": {
      "serverUrl": "https://kaiord.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kaiord": {
      "type": "http",
      "url": "https://kaiord.com/mcp"
    }
  }
}
```

## Tools

- `kaiord_convert`: Convert between FIT, TCX, ZWO, GCN and KRD
- `kaiord_validate`: Validate KRD JSON against the schema
- `kaiord_inspect`: Parse and summarise a fitness file
- `kaiord_diff`: Compare two fitness files field by field
- `kaiord_extract_workout`: Extract a structured workout definition
- `kaiord_list_formats`: List supported formats and capabilities
- `kaiord_get_format_spec`: Get a format specification
- `kaiord_round_trip_validate`: Validate a conversion round trip
- `kaiord_garmin_push`: Push a KRD workout to Garmin Connect (local only)

## FAQ

### Do I need to install anything?

Not for the hosted endpoint at kaiord.com/mcp, which needs no account. The local server runs with npx @kaiord/mcp.

### What does the hosted endpoint not do?

It has no Garmin or health tools, rejects file paths, accepts structured workouts only and caps requests at 65,536 bytes.

### Why does conversion ask for FTP?

GCN stores power in watts, so percent-of-FTP targets need the athlete's FTP.

### Is data stored?

The hosted endpoint stores and logs nothing, according to the docs.

### Is Kaiord free?

Yes. Kaiord is open source, so you can use and self-host it for free.

### How do I add Kaiord to Claude Code?

Run this command in your terminal: claude mcp add --transport http kaiord https://kaiord.com/mcp

### What are the best alternatives to Kaiord?

The closest alternatives to Kaiord are Tooluniverse, Oya Browser, ASTra, Later Stages and CARTESIAN ECU.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/kaiord
