Forkable
Arcade tools for Forkable — list this week's meals, browse menus, and pick what you want delivered
1.0.3Forkable Toolkit
Forkable is a workplace meal delivery service. This Arcade toolkit lets agents and users browse weekly menus, check dietary restrictions, and manage meal picks — all programmatically.
Capabilities
- Delivery schedule: Retrieve this week's delivery days, current pick status (open / locked / delivered), and available menus per day.
- Menu browsing: Fetch full menu details — sections, items, prices, and modifiers — for one or more menus.
- Dietary safety checks: Validate whether a specific item and modifier combination conflicts with the signed-in user's dietary restrictions before committing a pick.
- Meal management: Swap an existing meal pick to a different item, or skip a delivery day entirely (when still open for changes).
Secrets
This toolkit authenticates directly against Forkable using your account credentials. No OAuth flow or API key is involved.
-
FORKABLE_EMAIL— The email address associated with your Forkable account. This is the same email you use to log in at forkable.com. No special account tier or permissions are required beyond a standard active account. -
FORKABLE_PASSWORD— The password for your Forkable account. Retrieve or reset it via the Forkable login page. Store it as a secret rather than hardcoding it; it is used by the toolkit to authenticate your session on every request.
Store both secrets in Arcade using the Arcade secrets guide. You can manage them directly at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(5)
| Tool name | Description | Secrets | |
|---|---|---|---|
Check whether picking this item (with the given modifier selections) would
conflict with the signed-in user's dietary restrictions.
Returns the list of conflict tags (e.g. `["dairy_free"]`) — empty if the
item is safe. Call this before picking the item as a meal to warn the user, or
to let the agent pick a different item. | 2 | ||
Fetch the full menu (sections, items, prices, modifiers) for one or more menu IDs.
Each item ships with the `item_id` and `menu_id` you'll need to pick it as your meal. | 2 | ||
List your upcoming Forkable delivery days and what's currently picked for each.
Each entry shows the delivery date, current state (open / locked / delivered),
the meal currently assigned to you (`my_pick`), and the menu IDs whose items you
can swap your pick to. Results are sorted by delivery date.
An entry whose `my_pick.piece_id` is empty has no meal allocated to you yet, so
there is no pick to swap on it; picking a meal only replaces an existing pick. | 2 | ||
Replace your assigned meal on one delivery with a different menu item.
Only works on deliveries that already have a meal allocated to you (a
non-empty `my_pick.piece_id`). Forkable's `replacePiece` mutation swaps an
existing pick; it can't create one from nothing — initial allocation
happens on the Forkable side.
The mutation returns the refreshed delivery; this tool surfaces the new pick
and the updated amount due. | 2 | ||
Skip a day — removes your assigned meal from a Forkable order.
Use only when the delivery is still open for changes (`locked: false`
and not `past_late_order_deadline`). | 2 |