Forkable
Arcade tools for Forkable — list this week's meals, browse menus, and pick what you want delivered
1.0.3Forkable is a workplace meal delivery service; this toolkit lets an Arcade agent browse this week's delivery schedule, explore menus, check dietary restrictions, and swap or skip meals on behalf of the signed-in user.
Capabilities
- Delivery schedule: Retrieve upcoming delivery days, their open/locked/delivered state, current meal picks, and available menu IDs for each day.
- Menu browsing: Fetch full menus (sections, items, prices, modifiers) for one or more menu IDs, including the
item_idandmenu_idneeded to act on a selection. - Dietary safety checks: Validate a candidate item and its modifier selections against the user's dietary restrictions before committing, surfacing any conflicting tags.
- Meal management: Swap an existing meal pick for a different menu item (returns the refreshed pick and updated amount due), or skip a delivery day while it is still open for changes.
Secrets
This toolkit authenticates against Forkable using the user's account credentials directly. Both secrets must be configured before any tool will work.
-
FORKABLE_EMAIL— The email address associated with the user's Forkable account. This is the same address used to log in to forkable.com. No special permissions or account tier are required; any active Forkable account email is sufficient. -
FORKABLE_PASSWORD— The plaintext password for the same Forkable account. Retrieve or reset it through Forkable's standard login/password-reset flow at forkable.com. Store it as a secret rather than embedding it in tool calls.
Configure these secrets in your Arcade environment by following the Arcade secrets guide, or add them directly via the Arcade secrets dashboard.
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 |