Forkable
Arcade tools for Forkable — list this week's meals, browse menus, and pick what you want delivered
1.0.2Forkable Toolkit for Arcade
Forkable is a corporate lunch delivery service. This toolkit lets an agent or developer browse weekly menus, check dietary restrictions, and manage meal picks on behalf of a signed-in Forkable user.
Capabilities
- Weekly schedule & status — retrieve upcoming delivery days, current pick per day, delivery state (open / locked / delivered), and available menu IDs for swapping
- Menu browsing — fetch full menus for one or more menu IDs, including sections, items, prices, and modifier options with the IDs needed to place a pick
- Dietary safety checks — validate whether a specific item + modifier combination conflicts with the user's dietary restrictions before committing a pick
- Meal management — replace an existing assigned meal with a different item, or skip a delivery day entirely (subject to the order deadline and lock state)
Secrets
This toolkit authenticates directly against Forkable using your account credentials, so no OAuth flow 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 permissions or account tier are required beyond a normal active account. -
FORKABLE_PASSWORD— The password for your Forkable account. Retrieve or set it through the Forkable login/account settings page. Because this is a plaintext credential, treat it as sensitive: store it only in Arcade's secret store and never hard-code it in tool configurations or source code.
Store both secrets in the Arcade secret store. See the Arcade secrets guide for configuration instructions, or manage secrets 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 |