What can you do with this server?

The CookUnity MCP server enables comprehensive management of a CookUnity meal delivery account — from browsing menus to placing orders — directly through an AI assistant. Menu & Discovery * Browse the menu: Explore available meals for a delivery date with filters for category, diet, price, and rating * Search meals: Find meals by keyword across name, description, cuisine, chef, ingredients, and diet tags * Get meal details: View full nutritional info, allergens, ingredients, chef info, and diet tags for a specific meal Cart & Orders * View/manage cart: See, add, remove, or clear cart items for a specific delivery date * Confirm order: Lock in cart selections as a confirmed order before the cutoff deadline * Price breakdown: Get an estimated total including subtotal, taxes, delivery fee, discounts, credits, and promo savings Deliveries & Scheduling * Next delivery: Quickly see your nearest upcoming delivery and its meals * List deliveries: View all upcoming delivery weeks with status, cutoff deadlines, and skip state * Skip/unskip a delivery: Skip or restore a specific upcoming delivery week Account & History * User info: View your profile, subscription plan, delivery schedule, addresses, and available credits * Order history: Browse past orders with pagination and full invoice details (meal names, prices, reviews, billing breakdowns)

The CookUnity MCP server enables comprehensive management of a CookUnity meal delivery account — from browsing menus to placing orders — directly through an AI assistant.

Menu & Discovery

Browse the menu: Explore available meals for a delivery date with filters for category, diet, price, and rating
Search meals: Find meals by keyword across name, description, cuisine, chef, ingredients, and diet tags
Get meal details: View full nutritional info, allergens, ingredients, chef info, and diet tags for a specific meal

Cart & Orders

View/manage cart: See, add, remove, or clear cart items for a specific delivery date
Confirm order: Lock in cart selections as a confirmed order before the cutoff deadline
Price breakdown: Get an estimated total including subtotal, taxes, delivery fee, discounts, credits, and promo savings

Deliveries & Scheduling

Next delivery: Quickly see your nearest upcoming delivery and its meals
List deliveries: View all upcoming delivery weeks with status, cutoff deadlines, and skip state
Skip/unskip a delivery: Skip or restore a specific upcoming delivery week

Account & History

User info: View your profile, subscription plan, delivery schedule, addresses, and available credits
Order history: Browse past orders with pagination and full invoice details (meal names, prices, reviews, billing breakdowns)

cookunity-mcp-server

npm version npm downloads

⚠️ Unofficial. This project is not affiliated with, endorsed by, or associated with CookUnity in any way. It was built by reverse-engineering their internal APIs for personal use.

MCP server for CookUnity meal delivery service. Browse menus, manage carts, confirm orders, skip/unskip deliveries, and view order history.

Installation

npm install -g cookunity-mcp-server

Or run directly with npx:

npx cookunity-mcp-server

Related MCP server: DoorDash MCP Server

Tools (15)

Tool	Description
`cookunity_get_menu`	Browse meals with filters (category, diet, price, rating) & pagination
`cookunity_search_meals`	Search by keyword across name, description, cuisine, chef, ingredients, diet tags
`cookunity_get_meal_details`	Full nutritional info, allergens, and ingredients for a specific meal

Cart & Orders

Tool	Description
`cookunity_get_cart`	View cart contents for a specific delivery date
`cookunity_add_to_cart`	Add meal to cart by inventory_id and date
`cookunity_remove_from_cart`	Remove meal from cart by inventory_id
`cookunity_clear_cart`	Clear all cart items for a delivery date
`cookunity_confirm_order`	Confirm/place order — locks in cart items for delivery

Deliveries & Scheduling

Tool	Description
`cookunity_next_delivery`	Get nearest delivery with meals (order, cart, or auto-picks) — use for "what's my next delivery?"
`cookunity_list_deliveries`	All upcoming weeks with status, meals, cutoffs, skip state
`cookunity_skip_delivery`	Skip a delivery week
`cookunity_unskip_delivery`	Unskip a previously skipped week

Account & Pricing

Tool	Description
`cookunity_get_user_info`	User profile, plan, delivery days, addresses, credits
`cookunity_list_orders`	Order history with pagination
`cookunity_get_price_breakdown`	Price estimate with taxes, fees, credits, and promo discounts

Typical Workflow

1. cookunity_list_deliveries    → Find next editable delivery date + cutoff
2. cookunity_get_menu           → Browse available meals for that date
3. cookunity_search_meals       → Search for specific cuisines/proteins
4. cookunity_get_meal_details   → Check nutrition/allergens
5. cookunity_add_to_cart        → Add meals (repeat until plan is full)
6. cookunity_get_price_breakdown→ Verify total before confirming
7. cookunity_confirm_order      → Lock in the order ✅

Important: Without confirming, cart items are NOT locked in. CookUnity auto-fills with its own recommendations at the cutoff deadline.

Setup

Environment Variables

Variable	Required	Description
`COOKUNITY_EMAIL`	Yes	CookUnity account email
`COOKUNITY_PASSWORD`	Yes	CookUnity account password
`TRANSPORT`	No	`stdio` (default) or `http`
`PORT`	No	HTTP port when using `http` transport (default: 3000)

Configuration

Claude Desktop / Cursor / OpenClaw (stdio)

{
  "mcpServers": {
    "cookunity": {
      "command": "npx",
      "args": ["cookunity-mcp-server"],
      "env": {
        "COOKUNITY_EMAIL": "your@email.com",
        "COOKUNITY_PASSWORD": "your-password"
      }
    }
  }
}

Streamable HTTP (remote)

COOKUNITY_EMAIL=your@email.com COOKUNITY_PASSWORD=your-password TRANSPORT=http PORT=3000 npx cookunity-mcp-server

From Source (development)

git clone https://github.com/ggonzalezaleman/cookunity-mcp.git
cd cookunity-mcp
npm install
npm run build
node dist/index.js

API Details

This server reverse-engineers CookUnity's internal GraphQL APIs:

Menu Service (https://menu-service.cookunity.com/graphql) — meal browsing and search
Subscription Service (https://subscription-back.cookunity.com/graphql) — cart, orders, deliveries, user info

Authentication uses Auth0 with the cookunity realm. Tokens are cached and refreshed automatically.

Known Limitations

GraphQL introspection is disabled — schemas were reverse-engineered from frontend JS bundles and error probing
createOrder requires the exact number of meals matching the user's plan (e.g., 6 for a 6-meal plan)
Delivery window is currently hardcoded to 11:00–20:00 (matches most US plans)

License

MIT

CookUnity MCP