VanMoof

MCP Server for vanMoof bikes

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "stefanstranger-mcp-server-vanmoof": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "--with",
        "tzlocal",
        "mcp",
        "run",
        "C:\\Github\\mcp-server-vanmoof\\server.py"
      ],
      "env": {
        "VANMOOF_PASSWORD": "YOUR_VANMOOF_PASSWORD",
        "VANMOOF_USERNAME": "YOUR_VANMOOF_USERNAME"
      }
    }
  }
}

The VanMoof MCP Server connects AI agents to VanMoof services, enabling seamless access to rider context, bike details, rider cities and weekly rides. It lets you build prompts and automation that reason over real customer data in a safe, structured way, powering richer interactions with VanMoof features.

How to use

You can operate the VanMoof MCP Server from an MCP client to retrieve customer data, rider preferences, city and world ride statistics, and weekly ride summaries. Use the server to explore your VanMoof bike details, confirm rider configurations for a city, and compare weekly ride metrics across city and world scopes. The server exposes a set of tools that fetch data from your authenticated VanMoof account and present it in a consistent format for your prompts.

Typical usage patterns include: requesting bike details, listing supported rider cities with geolocation, retrieving rider preferences, and obtaining weekly ride statistics. You can compare city, world, and overall statistics for a given week and store results in a markdown table for reporting.

How to install

Prerequisites: you need Python installed and the uv toolchain to run the MCP server locally.

Clone the project repository that provides the VanMoof MCP Server code.
Install the uv tool and dependencies for the project.
Prepare credentials for VanMoof by creating a .env file based on the example and providing your VanMoof username and password.
Start the MCP server using the command below. You can run this in a terminal that has your Python environment active.

mcp dev c:\github\mcp-server-vanmoof\server.py

Additional setup notes

Launching the MCP Inspector is optional but recommended for testing and debugging MCP servers. You can start the inspector via the MCP CLI or via npx. The following commands illustrate both approaches. Use the environment variables VANMOOF_USERNAME and VANMOOF_PASSWORD to pass your credentials.

To launch via MCP CLI, after installing the MVP tooling, start the inspector with the dev flow.

To launch via npx, you can run the inspector with explicit environment variables and point to the VanMoof server. The command shown passes credentials directly for debugging.

Configuration overview

Configuration for the MCP client includes an MCP server entry that runs locally via uv. The command runs the server script and passes the required dependencies. Environment variables for VanMoof credentials are provided in the configuration.

Security note

Your VanMoof credentials are stored in the MCP client configuration as plain text. Do not share these with others.

Available tools

mcp_inspector

MCP Inspector is a developer tool for testing and debugging MCP servers.

get_customer_data

Retrieves customer data from the authenticated VanMoof user.

get_vanmoof_cities

Retrieves a list of city data from the VanMoof API.

get_rider_preferences

Retrieves rider preferences from the authenticated VanMoof user.

get_rides_summary

Retrieves total rides summary from the authenticated VanMoof user.

get_rides_for_week

Retrieves rides for a specific week from the authenticated VanMoof user.

get_city_rides_thisweek

Retrieves total city rides summary for this week.

get_world_rides_thisweek

Retrieves total world rides summary for this week.