go-strava-mcp

go-strava-mcp

Strava MCP server (Go)

Give Claude, Cursor, and other MCP clients real access to your Strava data.
Activities, routes, streams, athlete stats, clubs, uploads — one small binary, no runtime.

14 tools · server id strava · single binary · OAuth that just works

Drop it into your MCP config and ask your agent for recent runs, HR streams, YTD totals, or to update an activity description — over stdio, with tokens stored on your machine.

Built for local, single-user AI tool use. Sibling MCP servers in the same style: google-mcp, go-garmin.

Why this one

• Zero runtime — download a binary (or go install) and run; no Python, no Node
• Service-first tool names — hosts expose strava__activities_list, not ambiguous get_activities (aligned with google-mcp)
• Short server id — MCP server name is strava; binary / CLI is strava-mcp
• Local-first auth — strava-mcp auth once; tokens under ~/.strava/ (or $DATA_DIR/.strava/ in gantry); refresh is silent and coalesced with singleflight
• Works where you already work — Claude Desktop, Cursor, Claude Code, and any stdio MCP client

Quick start

1. Strava API app

1. Create an application at Strava API settings
2. Authorization Callback Domain — one hostname only (no localhost; … / comma lists). Use shotah.github.io for chat /auth strava (Pages catch page). localhost / 127.0.0.1 stay whitelisted for laptop strava-mcp auth even with that set. Forks: your Pages host or STRAVA_OAUTH_REDIRECT_URI — see ai-gantry docs/auth.md. Chat paste flow is implemented; smoke-test before relying on it.
3. Note the Client ID and Client Secret

2. Install

Pre-built binary (no Go required) — grab the archive for your platform from Releases:

tar xzf strava-mcp_*_darwin_arm64.tar.gz
chmod +x strava-mcp
mv strava-mcp ~/.local/bin/

macOS Gatekeeper: if the binary was downloaded from the browser, clear quarantine first: xattr -d com.apple.quarantine strava-mcp

Or with Go (1.26+):

go install github.com/shotah/go-strava-mcp@latest

3. Environment

export STRAVA_CLIENT_ID="your_client_id"
export STRAVA_CLIENT_SECRET="your_client_secret"
# optional: STRAVA_TOKEN_PATH=~/.strava/tokens.json

4. Authenticate

strava-mcp auth

Opens a browser, completes OAuth, writes tokens locally. You should see Authenticated as [Your Name]!.

Headless / chat paste (needs callback domain shotah.github.io): strava-mcp auth url → approve → strava-mcp auth exchange <code>. See ai-gantry docs/auth.md (smoke-test recommended).

5. MCP client config

Use server id strava so hosts expose tools as strava__activities_list.

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp",
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Restart the client. Ask things like “what were my last five runs?”, “list my saved routes”, or “open this strava.app.link and show the map”.

Tool reference

Host-facing names are {server}__{tool} → e.g. strava__activities_list.

Release builds also register utility_check_update / utility_self_update (not present on dev builds).

Configuration

CLI

Stdout is reserved for MCP JSON-RPC; all logs go to stderr.

Development

make tools          # goimports-reviser + golangci-lint
make install-hooks  # pre-commit: fmt → lint → test + ≥70% coverage
make check          # same gate as CI
make coverage       # coverprofile + threshold

go test ./...
STRAVA_CLIENT_ID=… STRAVA_CLIENT_SECRET=… go run . --debug

CI builds, lints, enforces ≥70% coverage on ./..., and publishes a coverage badge to gh-pages. Releases are cut with make release (GoReleaser on v* tags).

See CONTRIBUTING.md and SECURITY.md.

License

ISC

Forked from Stealinglight/StravaMCP; module path, tooling, and MCP naming reshaped for the shotah MCP set.

Links

• Strava API docs
• Model Context Protocol
• GitHub Releases