@striderlabs/mcp-grubhub

@striderlabs/mcp-grubhub

MCP server for Grubhub — let AI agents order food delivery.

Built by Strider Labs.

For Agents

This connector is designed for personal AI agents to autonomously order food on behalf of their human. Agents can:

• Understand context: "My user usually orders from Thai places in the morning and Italian restaurants in the evening"
• Optimize for preferences: Search restaurants that match dietary restrictions, price range, or past favorites
• Execute autonomously: Place complete orders (search → menu → cart → checkout) in a single agent turn
• Track delivery: Monitor orders and notify the user when food is arriving

Example agent workflow:

Agent: "The user said they're hungry. Search for Thai restaurants near 123 Main St, find Pad Thai, add a large order to the cart, and place it with default payment method."

The agent calls:

• grubhub_set_address → "123 Main St"
• grubhub_search_restaurants → { query: "Thai", cuisine: "Thai" }
• grubhub_get_restaurant → Browse menus
• grubhub_add_to_cart → Add Pad Thai
• grubhub_checkout → { confirm: true } to place order
• grubhub_track_order → Monitor delivery status

All in seconds, without human intervention.

Features

• 🔐 Login with email/password via browser automation
• 🔍 Search restaurants by name, cuisine, or food type
• 📜 Browse menus with full item details and prices
• 🛒 Manage cart — add items, view, and clear
• 💳 Place orders with a confirmation step
• 📍 Track orders with real-time status
• 📋 Order history — browse past orders
• 💾 Persistent sessions — stay logged in across restarts

Installation

npm install -g @striderlabs/mcp-grubhub

Or run directly with npx:

npx @striderlabs/mcp-grubhub

Configuration

Add to your MCP client configuration (e.g., Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Authentication

On first use, call grubhub_login with your email and password. The server uses Playwright browser automation to log in and saves session cookies to ~/.config/striderlabs-mcp-grubhub/cookies.json for future use.

To log out:

grubhub_logout

Available Tools

Authentication

Tool	Description
grubhub_status	Check login status
grubhub_login	Log in with email and password
grubhub_logout	Clear stored session

Ordering

Tool	Description
grubhub_set_address	Set delivery address
grubhub_search_restaurants	Search by query or cuisine
grubhub_get_restaurant	Get restaurant details and full menu
grubhub_add_to_cart	Add item to cart
grubhub_view_cart	View current cart
grubhub_clear_cart	Clear all cart items
grubhub_checkout	Preview or place order

Tracking

Tool	Description
grubhub_track_order	Track active order status
grubhub_get_orders	Get order history

Example Usage

1. grubhub_login — log in with your credentials
2. grubhub_set_address — set your delivery address
3. grubhub_search_restaurants — find a restaurant
4. grubhub_get_restaurant — browse the menu
5. grubhub_add_to_cart — add items
6. grubhub_checkout (confirm=false) — review order
7. grubhub_checkout (confirm=true) — place order
8. grubhub_track_order — track delivery

License

MIT — Strider Labs