MCP Uber Server

An MCP (Model Context Protocol) server for booking Uber rides through AI assistants.

Features

• OAuth 2.0 authentication with Uber

• Get price estimates for rides

• Request Uber rides

• Check ride status

• Cancel rides

Installation

Using npm (global installation)

Using npx (no installation required)

Setup

Step 1: Create an Uber Developer Account

1. Go to Uber Developer Dashboard

2. Click "Sign in" and either:

   • Use an existing Uber rider/driver account

   • Create a new account specifically for development

💡 Tip: For organizations, create an email alias (e.g., dev@yourcompany.com) instead of using a personal account for easier ownership transfer.

Step 2: Create a New App

1. In the Developer Dashboard, click "Create App" (top right corner)

2. Fill in the required information:

   • App Name: Your application name

   • Description: Brief description of what your app does

3. Click "Create"

Step 3: Get Your API Credentials

1. Navigate to your app in the dashboard

2. Go to the Auth tab

3. You'll find:

   • Client ID: Public identifier for your app

   • Client Secret: Private key (keep this secure!)

   • Server Token: For server-side requests

Step 4: Configure OAuth Settings

1. In the Auth tab, add your redirect URI:

   • For local testing: http://localhost:3000/callback

   • For production: Your actual callback URL

2. Select required scopes:

   • profile - User's basic profile information

   • request - Request rides on user's behalf

   • ride_request - View and manage active ride requests

⚠️ Note: The request scope is privileged and requires Uber approval for production use. During development, your account can use it without approval.

Step 5: Set Up Environment Variables

Create environment variables with your credentials (see Configuration section below)

Usage with Claude Desktop

Using npm (global installation)

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

Using npx

Add to your Claude Desktop configuration:

Available Tools

1. uber_get_auth_url - Get OAuth authorization URL

2. uber_set_access_token - Set user's access token

3. uber_get_price_estimates - Get price estimates for a ride

4. uber_request_ride - Request an Uber ride

5. uber_get_ride_status - Check ride request status

6. uber_cancel_ride - Cancel a ride request

OAuth Flow

1. Use uber_get_auth_url to get the authorization URL

2. User visits the URL and authorizes your app

3. After callback, exchange the code for an access token

4. Use uber_set_access_token to store the token

5. Now you can make API calls

Configuration

Environment Variables

The MCP server requires the following environment variables:

• UBER_CLIENT_ID: Your Uber app client ID

• UBER_CLIENT_SECRET: Your Uber app client secret

• UBER_REDIRECT_URI: OAuth callback URL (default: http://localhost:3000/callback)

• UBER_ENVIRONMENT: Either sandbox or production (default: sandbox)

Testing Your Integration

1. Use sandbox mode for testing:

   • Set UBER_ENVIRONMENT=sandbox in your environment

   • Sandbox mode simulates ride requests without real drivers

   • Perfect for development and testing

2. Test the OAuth flow:

   • Use the uber_get_auth_url tool to get an authorization URL

   • Visit the URL and authorize your app

   • After authorization, Uber will redirect to your callback URL with a code

   • Exchange the code for an access token (you'll need to set up your own callback handler)

   • Use uber_set_access_token to store the token in the MCP server

3. Setting up a callback handler:

   • For testing, you can use a simple Express server (see examples/oauth-server.js in the GitHub repo)

   • For production, implement a secure callback handler in your application

   • The callback URL must match exactly what's configured in your Uber app

Important Notes

Sandbox vs Production

• Sandbox Mode (default):

  • Simulated rides and drivers

  • No real charges

  • Perfect for testing

  • Limited to your developer account

• Production Mode:

  • Real rides and charges

  • Requires Uber approval for privileged scopes

  • Must pass Uber's review process

Security Best Practices

1. Never commit credentials: Keep your Client Secret secure

2. Use environment variables: Don't hardcode credentials

3. Implement proper token storage: The current in-memory storage is for demo only

4. Validate redirect URIs: Ensure your callback URLs are properly configured

API Limitations

• Rate limits apply (check Uber's documentation)

• Privileged scopes require approval for production use

• Sandbox mode has some limitations compared to production

Troubleshooting

• "Invalid scope" error: Your app needs approval for privileged scopes in production

• "Invalid redirect URI": Make sure your redirect URI exactly matches what's configured in the Uber dashboard

• "Unauthorized" errors: Check that your access token is valid and not expired

Resources

• Uber API Documentation

• OAuth 2.0 Guide

• Sandbox Testing Guide

• API Status Page