Skip to main content
Glama

RideWithGPS MCP Server

by boezzz

RideWithGPS MCP Server

🚴 Dear Cyclists! Welcome to the RideWithGPS MCP Server—your AI-powered companion for managing your cycling adventures. If you like this project, please consider giving it a star, or better yet, becoming a contributor!

A Model Context Protocol (MCP) server that provides access to the RideWithGPS API, allowing you to interact with routes, trips, events, and user data.

Requirements

  • Node.js: 18.0.0 or higher, 20.0.0 or newer recommanded (Download here)

Tools

This MCP server implements the following tools:

Route Retrival

  • get_routes: Retrieve a list of routes owned by the user on RideWithGPS, ordered by updated_at descending

    ⚠️ Known Limitation: This tool can only access routes that you personally own. Routes that are shared with you but belong to other people will not appear in your results.
    If you want to use a shared route with this server, please make a copy of it into your own RideWithGPS account first.

  • get_route_details: Retrieve full details for a specific route including track points, course points, and points of interest. You can find the available list of information here

Trip & Activity Data

  • 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. You can find the available list of information here

User Profile

  • get_current_user: Retrieve profile information for the user

Event Participation

  • 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

Data Synchronization

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

Setup

In command line, clone this repository and change into its directory

git clone https://github.com/boezzz/ridewithgps-mcp.git cd ridewithgps-mcp

Build the server app:

npm install npm run build

Configure Claude Desktop:

You can install the Claude desktop app which supports MCP. Other commonly seen MCP clients should also work.

You can get your RideWithGPS API credentials from:

  1. API Key: Visit the developer settings page in your RideWithGPS account and create an API client
  2. Authentication Token: Select the API Client you created and go to its edit page. Click on 'Create new Auth Token' to obtain a new authentication token.

Access Token Instructions

Then, open your Claude Desktop settings, go to Developers, and select 'Edit Config'. Alternatively, in your claude_desktop_config.json file, add a new MCP server:

{ "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" } } } }

You can now launch Claude desktop app and ask it to interact with your RideWithGPS data.

Example queries:

  • "Show me my recent routes"
  • "Get details for the century route I created yesterday"
  • "List my cycling trips from last month"
  • "What events do I have coming up that I'll probably chicken out of?"
  • "Show me my user profile so I can admire my optimistically low weight setting"
  • "Sync my data since last week when I pretended that walk to the coffee shop was a training ride"

To use RideWithGPS MCP Server on other local MCP Clients, please follow the same steps.

API Coverage

This MCP server implements the main RideWithGPS API endpoints for individual users, excluding organization-specific features.

For complete API documentation, see: https://github.com/ridewithgps/developers

Development

Contributors welcome! To contribute to this project:

  1. Fork this repository to your own GitHub account.
  2. Clone your fork locally.
  3. Install dependencies: npm install
  4. Make your changes to the TypeScript source files in src/
  5. Build the project: npm run build
  6. Test your changes using npm run inspector
  7. Commit and push your changes to your fork.
  8. Submit a pull request to the main repository for review.

Development Roadmap

  • Utilize OAuth for secure user authentication
  • Deploy the MCP server to Smithery/Glama for distribution
  • Incorporate geospatially-aware track points; currently, only the number is displayed
  • Make pagination optional; it would also be helpful to return trips in descending order by departed time instead of updated time.

License

This project is licensed under the MIT License - see the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

An AI-powered companion that provides access to the RideWithGPS API, allowing you to interact with cycling routes, trips, events, and user data through natural language.

  1. Requirements
    1. Tools
      1. Route Retrival
      2. Trip & Activity Data
      3. User Profile
      4. Event Participation
      5. Data Synchronization
    2. Setup
      1. API Coverage
        1. Development
          1. Development Roadmap
        2. License

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
            Last updated -
            18
            12
            59
            TypeScript
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            Provides access to Google Maps API functionality including geocoding, place search, direction routing, and distance calculations through a structured MCP interface.
            Last updated -
            13
            JavaScript
            MIT License
          • -
            security
            F
            license
            -
            quality
            An MCP tool that integrates with Amap API services, allowing AI to access geographic information, weather data, and route planning.
            Last updated -
            6
            Python
          • A
            security
            F
            license
            A
            quality
            An MCP server that enables AI assistants to book and manage Uber rides, including getting price estimates, requesting rides, checking ride status, and canceling rides.
            Last updated -
            6
            3
            JavaScript

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/boezzz/ridewithgps-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server