Forkable
Arcade Optimized
Arcade tools for Forkable — list this week's meals, browse menus, and pick what you want delivered
Author:Arcade
Version:
1.0.2Auth:No authentication required
5tools
5require secrets
Forkable 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 for upcoming deliveries.
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 a candidate item against the signed-in user's dietary restrictions before picking it, surfacing any conflict tags.
- Meal management: Swap an existing meal pick to a different item, or skip a delivery day entirely (when the order window is still open).
Secrets
This toolkit authenticates directly with Forkable using your account credentials. Both secrets are required at runtime.
FORKABLE_EMAIL— The email address associated with your Forkable account. This is the address you use to log in at forkable.com.FORKABLE_PASSWORD— The password for your Forkable account. This is the same password you enter on the Forkable login page. Store it only as a secret; never hard-code it.
Add both secrets in the Arcade dashboard or via the Arcade secrets API. See the Arcade secrets documentation for setup instructions: https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets. You can manage your secrets directly at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(5)
5 of 5 tools
Operations
Behavior
| 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 |
Last updated on