Garmin Sailing MCP

Garmin Sailing MCP

An MCP server that turns your Garmin watch into a sailing analytics tool. Combines GPS data from Garmin Connect with historical weather from Open-Meteo to give you sailing-specific insights — all accessible through Claude.

!Sailing Map Example

What it does

| Tool | Description | |---|---| | get_sailing_activities | List your recent sailing sessions | | get_sailing_activity | Detailed analysis: speed (knots), distance (nm), VMG, wind, tacks, point of sail | | get_sailing_map | Interactive map with GPS trace colored by speed + wind overlay |

Sailing analysis includes

• Speed in knots, distance in nautical miles
• Wind conditions during your sail (speed, direction, gusts) via Open-Meteo
• VMG (Velocity Made Good) — how efficiently you sailed relative to wind
• Maneuver detection — tack and jibe count from heading changes
• Point of sail distribution — % time close hauled, beam reach, broad reach, running
• Storm indicators — precipitation, cloud cover, CAPE
• Heart rate stats

Architecture

graph TD
    A[User] -->|activity_id| B[get_sailing_map]
    B --> C[Garmin Connect API]
    B --> D[Open-Meteo API]
    C -->|track, speed, HR| E[Sailing Analyzer]
    D -->|wind, rain, temp| E
    E -->|JSON| F[Leaflet Map UI]
    F --> G[Speed-colored trace]
    F --> H[Wind arrow + stats]

Setup

1. Clone and install

git clone https://github.com/vinicius-saraiva/garmin-sailing-mcp.git
cd garmin-sailing-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .

2. Authenticate with Garmin

python -m garmin_sailing setup

This will ask for your Garmin Connect email and password (+ MFA if enabled). Tokens are stored locally in ~/.garminconnect.

3. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "garmin-sailing": {
      "command": "/path/to/garmin-sailing-mcp/.venv/bin/python",
      "args": ["-m", "garmin_sailing", "serve"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Replace /path/to/garmin-sailing-mcp with the actual path where you cloned the repo.

Restart Claude Desktop and you're ready to sail!

Usage

Just talk to Claude:

• "How was my last sailing session?"
• "Show me the map of my latest sail"
• "Compare my last 5 sailing activities"
• "What were the wind conditions during my sail on March 7?"

Requirements

• Python 3.11+
• A Garmin watch that records sailing activities
• Claude Desktop (for the interactive map) or Claude Code

Credits

• garminconnect — Garmin Connect API client
• Open-Meteo — Free weather API (no key needed)
• FastMCP — MCP server framework
• Leaflet — Interactive maps