Step 1: Prerequisites

• Install Node.js 16 or higher
• Install TypeScript 4.5 or higher
• Obtain a valid Mapbox API key

Step 2: Set API Key

Set your API key as an environment variable: bash export MAPBOX_ACCESS_TOKEN=your_api_key_here

Step 3: Integrate with Claude Desktop

Add the following configuration to your Claude Desktop config file:

{ "mcpServers": { "mapbox-mcp-server": { "command": "node", "args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"], "env": { "MAPBOX_ACCESS_TOKEN": "your-api-key" } } } }

Step 4: Use Navigation Tools

• Get directions between coordinates using mapbox_directions
• Get directions between places using mapbox_directions_by_places
• Calculate travel time and distance matrices between coordinates using mapbox_matrix
• Calculate travel time and distance matrices between places using mapbox_matrix_by_places

Step 5: Use Search Tools

• Search for places and convert addresses into coordinates using mapbox_geocoding