home / mcp / ridewithgps mcp server

RideWithGPS MCP Server

MCP Server for Ride With GPS

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "boezzz-ridewithgps-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/ridewithgps-mcp/build/index.js"
      ],
      "env": {
        "RWGPS_API_KEY": "your_api_key_here",
        "RWGPS_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

RideWithGPS MCP Server is an AI-assisted bridge that gives you programmatic access to your RideWithGPS data through an MCP client. It lets you retrieve and inspect your routes, trips, events, and user profile, enabling automation and conversational queries over your cycling data.

How to use

Use an MCP client to connect to the RideWithGPS MCP Server and perform actions such as listing your routes, viewing route details, listing trips, and syncing your data. You can ask for things like showing your recent routes, getting details for a specific route, listing trips from a time period, or retrieving your user profile. To work with this server, you need to configure an MCP client with the server command and required credentials. The server exposes endpoints for routes, trips, events, and user data via MCP calls.

How to install

Prerequisites: Node.js 18.0.0 or higher. Node 20.0.0 or newer is recommended.

Clone the MCP server repository and install dependencies, then build the project.

Installation steps

git clone https://github.com/boezzz/ridewithgps-mcp.git
cd ridewithgps-mcp
npm install
npm run build

Configure your MCP client and run the server locally

Install the Claude Desktop app (or another MCP client) and prepare to run the local server with your RideWithGPS credentials.

Server configuration snippet for Claude Desktop

{
  "mcpServers": {
    "ridewithgps-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/ridewithgps-mcp/build/index.js"],
      "env": {
        "RWGPS_API_KEY": "your_api_key_here",
        "RWGPS_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Available tools

get_routes

Retrieve a list of routes owned by the user on RideWithGPS, ordered by updated_at descending. Note: only routes owned by you are returned.

get_route_details

Retrieve full details for a specific route including track points, course points, and points of interest.

get_trips

Retrieve a list of trips/activities owned by the user on RideWithGPS, ordered by updated_at descending.

get_trip_details

Retrieve full details for a specific trip including track points and performance data.

get_current_user

Retrieve profile information for the user.

get_events

Retrieve a paginated list of events owned by the user, ordered by created_at descending.

get_event_details

Retrieve full details for a specific event including associated routes.

sync_user_data

Retrieve items (routes and/or trips) that the user has interacted with since a given datetime.