Forkable MCP server
Commit Oct 20, 2026Lets an AI client order and manage Forkable lunches, browse menus, track deliveries, and rate meals.
Also known as colinds/forkable-mcp
- Stars
- 2
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 20, 2026
- License
- MIT
What is Forkable MCP?
Forkable lets an AI client order and manage Forkable lunches, browse menus, track deliveries, and rate meals. It exposes 13 tools, such as open_forkable, prepare_meal, list_deliveries.
Summary generated from the project's README
About Forkable MCP server
Managing your lunch orders and tracking deliveries directly from an AI client is what this server enables. It allows users to interact with Forkable services through tools like Claude Desktop, Cursor, or Codex without needing to open the official application. You can browse menus, search for specific items, and receive meal recommendations to help decide what to eat.
Users can perform complex tasks such as adding, replacing, or removing meals, as well as confirming deliveries. The server also provides real-time updates on courier ETAs, arrival times, and office access notes. For feedback, you can rate meals on a scale of 1 to 5 and provide written comments or specific issue codes.
Setup requires Bun or Node and uses your existing Forkable web session rather than an API key. You can authenticate by importing a session from Chrome or Edge, using email and password credentials, or providing a Cookie header. This connection is managed locally via a session file stored in your home directory.
What you can do with it
- 1Plan weekly lunch ordersAsk your AI client to show your upcoming deliveries and help you select meals for the week.
- 2Track live food deliveriesRequest the current status and estimated arrival time of your lunch courier.
- 3Provide meal feedbackSubmit a rating and written review for a meal you recently ate.
Written from the project's README. Every use case is checked against a quote from it.
Forkable MCP tools 13
Detected from the READMEopen_forkableprepare_meallist_deliveriesget_delivery_statusget_menussearch_itemsrecommend_mealsget_profileset_mealset_meal_allremove_mealrate_meal
Show all 13 toolsShow fewer tools
confirm_delivery
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablecolinds/forkable-mcp is public and reachablegithub.com/colinds/forkable-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-20github.com/colinds/forkable-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubforkable-mcp
Order and manage your Forkable lunches from Claude, Codex, Cursor, or another MCP client. You can see your week, browse menus, get recommendations, change meals, and check where lunch is without opening the Forkable app.
[!WARNING] This is an unofficial project and is not affiliated with Forkable. It uses your Forkable web session and an undocumented API that may change.
Features
- See upcoming deliveries and the meals already selected
- Track courier ETAs, arrival times, and office access notes
- Browse and search menus
- Get Forkable's meal recommendations
- Add, replace, remove, and confirm meals
- Rate meals from 1–5 and leave written feedback
- Use it from any MCP client that can launch a stdio server
Quick start
You need Bun or Node.
First, log in to Forkable in Chrome and import that session:
bunx --bun forkable-mcp@latest --auth --chrome # Node: npx forkable-mcp@latest --auth --chrome
Then add it to your MCP client:
| Client | Command or configuration |
|---|---|
| Claude Code | claude mcp add forkable -- bunx --bun forkable-mcp@latest |
| Codex | codex mcp add forkable -- bunx --bun forkable-mcp@latest |
| Claude Desktop or Cursor | Add the JSON below under mcpServers |
| VS Code | Add the JSON below under servers in .vscode/mcp.json |
{
"mcpServers": {
"forkable": {
"command": "bunx",
"args": ["--bun", "forkable-mcp@latest"]
}
}
}
Restart or reconnect your client, then ask something like:
What's for lunch this week?
Meal browser
Browse and choose meals visually in clients that support MCP Apps. Open Forkable from the sidebar, or ask to see your meals.
Skills
Three agent skills ship with the server:
forkablecontains the shared instructions for meals, deliveries, and tool useforkable-fridayadds a week-ahead planning routine on top offorkableforkable-setupcovers installation and authentication
Install them with:
npx skills add colinds/forkable-mcp
npx skills add colinds/forkable-mcp --list # See what's included first
The source files are in skills/.
Tools
| Tool | What it does |
|---|---|
open_forkable |
Opens the interactive meal browser in MCP Apps clients |
prepare_meal |
Chooses and customizes a meal through forms or chat |
list_deliveries |
Shows upcoming deliveries and selected meals |
get_delivery_status |
Shows courier status, ETA, arrival time, tracking, and access notes |
get_menus |
Lists menus and item options for a delivery |
search_items |
Searches a delivery's menus |
recommend_meals |
Returns Forkable's meal recommendations |
get_profile |
Shows the signed-in Forkable user |
set_meal |
Adds or replaces a meal |
set_meal_all |
Sets the same meal on several deliveries |
remove_meal |
Removes a meal |
rate_meal |
Rates a meal or edits its score and text feedback |
confirm_delivery |
Confirms or unconfirms a delivery |
Forkable still decides whether a change is allowed, including deadlines, restaurant capacity, and billing rules.
To skip a delivery, use list_deliveries and remove each selected owned meal with remove_meal.
This removes those meals; it does not change your auto-order settings. Compare selected meals with
recommend_meals when choosing alternatives.
Meal ratings
List the delivery first, supplying from and to for past meals. Each owned meal includes rating:
null means Forkable has not made a rating available, while a rating with level: null is unrated.
Use rate_meal with the delivery ID, the meal's pieceId, and a level from 1–5. It previews first;
call again with the same arguments and its confirmToken to submit. The search starts 14 days ago
by default; pass both from and to to limit the lookup to an older day or week.
Optional reasons, comment, forGuest, and allowRatingFollowUps edit the feedback. Omitted fields
keep their current values; an empty comment or reason array clears it. Levels 4–5 accept compliment
codes, while 1–3 accept issue codes listed in the tool schema. Known incompatible stored reasons are
removed, unknown server codes are preserved, and duplicates are ignored. Score changes show both
the old and new score in the preview. Marking a meal as a guest meal excludes its rating from future
suggestions. Follow-up preferences apply to this rating without changing your account settings.
If Forkable has not reported a follow-up preference, omitting it lets Forkable apply its default,
which may allow its team to contact you about your feedback. Set allowRatingFollowUps: false
to opt out for the rating.
Existing attachments are kept; photo editing and buffet ratings are not supported.
Authentication
There is no API key. The server reuses a Forkable web session and stores it in
~/.forkable-mcp/session.json.
Import from a browser
Log in at forkable.com, then run:
bunx --bun forkable-mcp@latest --auth --chrome # Node: npx forkable-mcp@latest --auth --chrome
Chrome and Edge profiles are found automatically on macOS, Linux, and Windows. Browser import is best-effort because browser storage and operating-system security rules vary.
On macOS, Keychain may ask for permission once per browser profile. Limit the scan if you know which profile you use:
bunx --bun forkable-mcp@latest --auth --chrome --profile "Profile 1"
Arc is supported on macOS:
bunx --bun forkable-mcp@latest --auth --chrome --browser arc
Brave and Chromium are also supported. On Linux or Windows, you may need to pass a profile directory
or cookie database with --profile.
Email and password
bunx --bun forkable-mcp@latest --auth --login --email you@example.com # Node: npx forkable-mcp@latest --auth --login --email you@example.com
The command asks for your password without showing it. Password-based sessions can sign in again after they expire. SSO-only accounts need a browser or cookie import instead.
For non-interactive use, send the password on standard input with --password-stdin, or set
FORKABLE_EMAIL and FORKABLE_PASSWORD.
Copy as cURL
If browser import cannot find your session, copy an authenticated Forkable GraphQL request from your browser's developer tools:
- Open Forkable, then open Developer Tools and select Network.
- Reload the page and filter for
graphql. - Right-click a request to
/api/v2/graphqland choose Copy as cURL. - Pipe the copied command into the auth command:
pbpaste | bunx --bun forkable-mcp@latest --auth # Node: pbpaste | npx forkable-mcp@latest --auth
Only the Cookie header is imported. You can also save the copied command and pass it with
--file ./forkable.curl, or set FORKABLE_COOKIE to the full Cookie header.
Cookie-based sessions cannot refresh themselves. Import the cookie again when it expires.
Configuration
All settings are optional. Bun reads .env automatically; with Node, set them in the MCP server's
environment.
| Variable | What it does |
|---|---|
FORKABLE_EMAIL |
Email for non-interactive login and session refresh |
FORKABLE_PASSWORD |
Password used with FORKABLE_EMAIL |
FORKABLE_MFA |
MFA code for password login |
FORKABLE_COOKIE |
Full Forkable Cookie header for headless or SSO authentication |
FORKABLE_CSRF |
Sets the initial CSRF token; normally unnecessary |
FORKABLE_MAX_TOTAL |
Local per-meal spending limit in dollars |
FORKABLE_MCP_HOME |
Changes where the session is stored |
FORKABLE_MAX_TOTAL is a local limit, not a Forkable allowance or billing rule. Billing information
is shown as Forkable reports it.
From source
bun install
bun run auth --chrome
bun run start
Development
bun test
bun run test:tz
bun run check
bun run smoke
License
MIT © Colin D'Souza
Forkable MCP questions
What tools does Forkable MCP provide?
It exposes 13 tools, including open_forkable, prepare_meal, list_deliveries, get_delivery_status, get_menus.
Can I use this with Claude Desktop or Cursor?
Yes, you can add the server to Claude Desktop or Cursor by adding the provided JSON configuration under the mcpServers key.
Does this server support SSO accounts?
SSO-only accounts require a browser or cookie import because they cannot use the standard email and password login method.
What can I do with the meal browser?
You can browse and choose meals visually in MCP Apps clients that support the feature.