@striderlabs/mcp-lyft

MCP server connector for Lyft ride-sharing — request rides, get fare estimates, and track trips via browser automation.

Installation

npm install -g @striderlabs/mcp-lyft

Or run directly with npx:

npx @striderlabs/mcp-lyft

MCP Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "lyft": {
      "command": "npx",
      "args": ["@striderlabs/mcp-lyft"]
    }
  }
}

Tools

status

Check current session and route status.

Returns: Login state, user info, and saved pickup/destination.

---

login

Authenticate with your Lyft account.

Parameter	Type	Required	Description
identifier	string	Yes	Email or phone number
password	string	Yes	Lyft account password
headless	boolean	No	Run browser headlessly (default: true)

Note: If Lyft requires a verification code (OTP), you must complete sign-in manually in a browser first.

---

logout

Clear saved session, cookies, and route data.

---

set_pickup

Set the pickup location for your ride.

Parameter	Type	Required	Description
location	string	Yes	Address or place name (e.g. "Times Square, NYC")

---

set_destination

Set the destination for your ride.

Parameter	Type	Required	Description
location	string	Yes	Address or place name (e.g. "JFK Airport")

---

get_fare_estimate

Get fare estimates for the current pickup/destination route.

Requires: Both pickup and destination to be set via set_pickup and set_destination.

Returns: List of ride types with estimated fares and ETAs.

---

get_ride_options

Get available Lyft ride types for the current route.

Requires: Login + both pickup and destination set.

Returns: Available options (Lyft, Lyft XL, Lux, Lux Black, etc.) with prices and wait times.

---

request_ride

Request a Lyft ride. Returns a preview by default — set confirm=true to actually book.

Parameter	Type	Required	Description
ride_type	string	No	Ride type (default: "Lyft")
confirm	boolean	No	Set true to book (default: false — preview)

Requires: Login + both pickup and destination set.

---

get_ride_status

Get the status of your current or most recent Lyft ride.

Requires: Login.

Returns: Driver info, ETA, vehicle details, and trip status.

---

cancel_ride

Cancel a pending or active ride.

Parameter	Type	Required	Description
reason	string	No	Optional cancellation reason

Note: Cancellation fees may apply depending on timing.

---

get_ride_history

Get recent ride history.

Parameter	Type	Required	Description
limit	number	No	Number of rides to return (default: 10)

Returns: List of past rides with date, route, fare, and status.

---

Typical Workflow

1. login          → Authenticate with Lyft
2. set_pickup     → "123 Main St, San Francisco, CA"
3. set_destination → "SFO Airport"
4. get_fare_estimate → See prices for all ride types
5. request_ride   → Preview the ride (confirm=false)
6. request_ride   → confirm=true to actually book
7. get_ride_status → Track your driver
8. cancel_ride    → Cancel if needed

Session Storage

Session data is stored locally at ~/.striderlabs/lyft/:

File	Contents
cookies.json	Browser session cookies
auth.json	Login metadata (identifier, time)
route.json	Saved pickup/destination

Technical Details

• Uses Playwright (Chromium) for browser automation
• Stealth techniques applied to avoid bot detection
• Cookies persist across MCP calls for seamless sessions
• Default geolocation: New York City
• User-agent: Chrome 120 on macOS

Important Notes

• OTP/Verification: Lyft frequently requires SMS or email verification codes. If prompted, complete sign-in manually in a browser — cookies will be reused.
• CAPTCHA: If a CAPTCHA appears, complete it manually in a browser to establish a session.
• Cancellation Fees: Lyft may charge a fee if you cancel after a driver has been assigned.
• Mobile vs Web: Some Lyft features may only be available in the mobile app and not accessible via browser automation.

License

MIT © Strider Labs