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 lunch delivery service. This Arcade toolkit lets agents browse weekly menus, check dietary restrictions, and manage meal picks on behalf of a user.
Capabilities
- Weekly schedule & status — retrieve upcoming delivery days, current picks, delivery states (open / locked / delivered), and available menu IDs for each day
- Menu browsing — fetch full menus including sections, items, prices, and modifier options for one or more menu IDs
- Meal selection & modification — swap an existing meal pick for a different item, with full modifier support; skip a delivery day when the order is still open
- Dietary safety checks — validate a candidate item against the signed-in user's dietary restrictions before confirming a pick, returning conflicting tags so the agent can warn the user or choose an alternative
Secrets
This toolkit authenticates directly with Forkable using an email/password pair. Both secrets must be configured before any tool call will succeed.
-
FORKABLE_EMAIL— The email address associated with your Forkable account. This is the same address you use to log in to the Forkable web app. -
FORKABLE_PASSWORD— The password for your Forkable account. This is your standard Forkable login password. Because this credential grants full account access, treat it as sensitive and consider using a dedicated or rotated password if your Forkable account supports it.
Store both secrets in Arcade before using the toolkit. See the Arcade secrets guide for configuration instructions, or add 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 |