name: grubhub
description: Enables Claude to browse restaurants, manage orders, and track deliveries on Grubhub
version: 1.0.0
author: Canifi
category: food

Grubhub Skill

Overview

Automates Grubhub operations including restaurant browsing, order tracking, and perks management through browser automation. Note: Actual orders are not automated for security.

Quick Install

curl -sSL https://canifi.com/skills/grubhub/install.sh | bash

Or manually:

cp -r skills/grubhub ~/.canifi/skills/

Setup

Configure via canifi-env:

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set GRUBHUB_EMAIL "[email protected]"
canifi-env set GRUBHUB_PASSWORD "your-password"

Privacy & Authentication

Your credentials, your choice. Canifi LifeOS respects your privacy.

Option 1: Manual Browser Login (Recommended)

If you prefer not to share credentials with Claude Code:
1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

If you're comfortable sharing credentials, you can store them locally:

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

Capabilities

• Browse restaurants and menus
• Search cuisines and dishes
• Track active orders
• View order history
• Manage saved restaurants
• Check Grubhub+ benefits
• Find deals and perks
• View pickup options

Usage Examples

Example 1: Browse Restaurants

User: "Find Indian restaurants on Grubhub"
Claude: I'll find Indian food.
- Navigate to grubhub.com
- Search "Indian"
- Filter by available
- Sort by rating
- Present top options

Example 2: Check Perks

User: "What Grubhub perks do I have?"
Claude: I'll check your perks.
- Navigate to account perks
- View available offers
- List active deals
- Note expiration dates

Example 3: Track Order

User: "Track my Grubhub order"
Claude: I'll track your delivery.
- Navigate to Order History
- Find active order
- Check delivery status
- Report ETA

Example 4: Find Pickup

User: "Find restaurants with pickup near me"
Claude: I'll find pickup options.
- Filter by pickup
- Browse nearby restaurants
- Note pickup times
- Present options

Authentication Flow

1. Navigate to grubhub.com via Playwright MCP
2. Click Sign In
3. Enter email from canifi-env
4. Enter password
5. Handle 2FA if enabled (notify user via iMessage)
6. Verify account access
7. Maintain session cookies

Error Handling

• Login Failed: Clear cookies, verify credentials
• Session Expired: Re-authenticate automatically
• 2FA Required: iMessage for verification code
• Restaurant Closed: Note hours
• No Delivery: Check pickup option
• Order Not Found: Check order ID
• Perks Expired: Note expiration
• Address Error: Verify delivery address

Self-Improvement Instructions

When encountering new Grubhub features:
1. Document new UI elements
2. Add support for new features
3. Log successful patterns
4. Update for Grubhub changes

Notes

• Orders not automated for security
• Grubhub+ for free delivery
• Pickup option available
• Perks and rewards program
• Corporate accounts available
• Scheduled orders supported
• Part of Just Eat Takeaway