# @striderlabs/mcp-starbucks

MCP server for Starbucks — let AI agents search the menu, customize drinks, find stores, place mobile pickup orders, and manage Starbucks Rewards.

## Features

- **Full menu search** — search by name, category, or dietary preference (vegan, vegetarian, etc.)
- **Item customization** — size, milk type, syrups, espresso shots, temperature, foam, and more
- **Cart management** — add items, view cart, adjust quantities
- **Store finder** — find nearby Starbucks locations with hours and features
- **Mobile ordering** — place mobile pickup orders (requires Starbucks account)
- **Starbucks Rewards** — check Star balance, reward level, and redeem rewards
- **Order history** — view past orders and quickly reorder favorites
- **Session persistence** — cookies saved at `~/.striderlabs/starbucks/cookies.json`

## Installation

```bash
npm install -g @striderlabs/mcp-starbucks
npx playwright install chromium
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "starbucks": {
      "command": "striderlabs-mcp-starbucks",
      "env": {
        "STARBUCKS_EMAIL": "your-email@example.com",
        "STARBUCKS_PASSWORD": "your-password"
      }
    }
  }
}
```

Credentials can also be passed directly via the `starbucks_login` tool.

## Tools

| Tool | Description |
|------|-------------|
| `starbucks_status` | Check connection and login status |
| `starbucks_login` | Authenticate with Starbucks credentials |
| `starbucks_logout` | Clear session cookies |
| `search_menu` | Search menu by name, category, or dietary preference |
| `get_item_details` | Get full item details and customization options |
| `customize_item` | Build a customized drink or food order |
| `add_to_cart` | Add customized item to cart |
| `view_cart` | View current cart with pricing |
| `get_nearby_stores` | Find nearby Starbucks locations |
| `select_store` | Select pickup store |
| `place_order` | Submit mobile pickup order |
| `get_order_status` | Track order status and pickup time |
| `get_rewards` | Check Star balance and available rewards |
| `redeem_reward` | Apply a reward to current order |
| `get_order_history` | View past orders |
| `reorder_favorite` | Quick reorder from a past order |

## Example Workflow

```
1. starbucks_status           → check if logged in
2. starbucks_login            → authenticate (if needed)
3. search_menu query="latte"  → browse menu options
4. get_item_details itemId="hot-latte"
                              → see customization options
5. customize_item itemId="hot-latte"
     customizations={"size":"grande","milk":"oat","syrup":"vanilla"}
6. add_to_cart quantity=1     → add to cart
7. view_cart                  → review order
8. get_nearby_stores address="94105"
                              → find pickup location
9. select_store storeId="sbux-1001"
10. get_rewards               → check available rewards
11. redeem_reward rewardId="reward-123"
                              → apply reward (optional)
12. place_order confirm=false → preview order
13. place_order confirm=true  → submit order
14. get_order_status          → track preparation
```

## Customization Options

### Size
- `short` (8 fl oz) — hot drinks only
- `tall` (12 fl oz)
- `grande` (16 fl oz)
- `venti_hot` (20 fl oz) — hot drinks
- `venti_cold` (24 fl oz) — cold drinks

### Milk
- `2percent`, `nonfat`, `whole` — standard, no charge
- `oat`, `almond`, `coconut`, `soy` — +$0.70

### Espresso Roast
- `signature` (Starbucks Signature Espresso Roast)
- `blonde` (Blonde Espresso Roast)
- `decaf`

### Syrups / Flavorings
`vanilla`, `caramel`, `hazelnut`, `toffee_nut`, `cinnamon_dolce`, `peppermint`, `sugar_free_vanilla`, `brown_sugar`, `mocha`, `white_mocha`

### Temperature (hot drinks)
`hot`, `extra_hot`, `warm`, `kids_temp`

### Foam
`standard`, `extra_foam`, `no_foam`, `light_foam`

## Technical Details

- **Browser automation**: Playwright (Chromium) with stealth patches
- **Session persistence**: Cookies stored at `~/.striderlabs/starbucks/cookies.json`
- **Transport**: MCP stdio
- **Ordering**: Uses Starbucks web ordering API with Playwright automation fallback

## Environment Variables

| Variable | Description |
|----------|-------------|
| `STARBUCKS_EMAIL` | Starbucks account email (optional — can use starbucks_login tool) |
| `STARBUCKS_PASSWORD` | Starbucks account password (optional) |

## License

MIT — [Strider Labs](https://striderlabs.ai)