# grubhub [Health: Active]

**Category:** 📦 Delivery  
**Repository:** https://github.com/markswendsen-code/mcp-grubhub  
**GitHub Stars:** 1  
**npm Downloads (last month):** 154  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/grubhub

## Description
Grubhub MCP server — search, order, and track food delivery. By Strider Labs.

## Tools
Capabilities this server exposes over MCP:

- **grubhub_status** — Check if the user is logged in to Grubhub. Returns auth status and instructions if not authenticated. Call this before any other Grubhub operations.
- **grubhub_login** — Log in to Grubhub with email and password via browser automation. Session is saved for future use.
- **grubhub_logout** — Clear the stored Grubhub session. The user will need to log in again.
- **grubhub_set_address** — Set the delivery address for Grubhub orders. Must be set before searching for restaurants.
- **grubhub_search_restaurants** — Search for restaurants on Grubhub by name, food type, or cuisine. Returns a list of restaurants with ratings, delivery times, and fees.
- **grubhub_get_restaurant** — Get full details for a restaurant: menu categories, items with prices, hours, and address.
- **grubhub_add_to_cart** — Add a menu item to the cart.
- **grubhub_view_cart** — View current cart contents, including items, quantities, and totals.
- **grubhub_clear_cart** — Remove all items from the current cart.
- **grubhub_checkout** — Proceed to checkout. Set confirm=false to preview order details before placing; set confirm=true to actually place the order.
- **grubhub_track_order** — Track the status of an active Grubhub order — delivery progress, estimated time, and driver info.
- **grubhub_get_orders** — Get Grubhub order history — past and active orders.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What grubhub MCP server does

The grubhub MCP server connects an MCP-compatible AI client to Grubhub for food-delivery tasks. An agent can authenticate with a Grubhub account, set a delivery address, search for restaurants by query or cuisine, inspect restaurant details and menus, and select items for an order.

The ordering flow covers the cart and checkout stages as well. Agents can add items, inspect the current cart, remove everything with the clear-cart operation, and either preview an order or place it after confirmation. After an order is active, the server can return its delivery status. A separate order-history tool exposes previous orders.

This fits workflows where an agent needs to handle several related delivery actions rather than only retrieve restaurant information. For example, an agent can find a cuisine near a specified address, inspect available menu items, assemble a cart, review the checkout state, and submit the order.

## How it works

The grubhub MCP server exposes Grubhub operations as MCP tools. A typical sequence begins with `grubhub_login`, followed by `grubhub_set_address` and `grubhub_search_restaurants`. The agent can then call `grubhub_get_restaurant` to retrieve a restaurant’s details and full menu before using `grubhub_add_to_cart`.

Checkout has an explicit confirmation step. Calling `grubhub_checkout` with confirmation disabled previews the order; calling it with confirmation enabled places it. This gives an agent a point at which to show or evaluate the order before committing it. `grubhub_track_order` handles active delivery status, while `grubhub_get_orders` retrieves order history.

Authentication uses Playwright browser automation. After a successful login, the server saves session cookies at `~/.config/striderlabs-mcp-grubhub/cookies.json`, allowing the session to persist across restarts. `grubhub_status` checks whether a session is available, and `grubhub_logout` clears the stored session.

## Setup and configuration

Install the npm package with:

```bash
npm install @striderlabs/mcp-grubhub
```

The server can also be launched directly with `npx @striderlabs/mcp-grubhub`. For Claude Desktop, add an MCP entry that runs `npx` with `-y` and `@striderlabs/mcp-grubhub` as its package argument. On first use, call `grubhub_login` with the Grubhub email address and password. No environment variables are documented as required; credentials are supplied through the login tool, and session cookies are stored in the stated local path.

## Tools and capabilities

- Check login state with `grubhub_status`.
- Log in or clear the saved session with `grubhub_login` and `grubhub_logout`.
- Set a delivery address with `grubhub_set_address`.
- Search restaurants by query or cuisine with `grubhub_search_restaurants`.
- Retrieve restaurant information and menus with `grubhub_get_restaurant`.
- Add, inspect, or clear cart contents with the cart tools.
- Preview or submit an order with `grubhub_checkout`.
- Track an active order and inspect past orders.

## Limitations and notes

The server requires Grubhub account credentials for authenticated actions and relies on browser automation to complete login. Placing an order is an external action, so agents should use the checkout confirmation behavior deliberately: preview first, then submit only when the order is approved. The documented session location contains authentication cookies and should be protected accordingly.

_Full upstream README: https://allmcps.com/mcp/grubhub/readme_