Group orders leave you with receipts to read and friends who owe you money. This plugin gives Codex and Claude Code 4 tools that list your orders, save itemized receipts and keep a debt ledger up to date. It cannot order or pay.
Features
- Lists orders: order metadata from your Uber Eats account, saved as
index.json. - Saves receipts: itemized receipts as JSON, with an index and a summary.
- Keeps a group-order ledger: adds new debts to
debts.csvand keeps paid states, dates, notes and real names. - Exports a Safari session: writes the live cookie to a mode-600 file, on macOS.
Quick start
claude plugin marketplace add zyx1121/marketplace
claude plugin install ubereats@zyx1121
Codex: codex plugin marketplace add zyx1121/marketplace, then codex plugin add ubereats@zyx1121. Log in to Uber Eats in Safari, open a new session and ask "List my Uber Eats orders from this month".
The plugin needs Bun and uv on the host PATH. The MCP server ships bundled.
Usage
| Tool | Result | Writes |
|---|---|---|
ubereats_list_orders | order metadata | index.json in out |
ubereats_fetch_receipts | receipts for the selected orders | receipt JSON, an index and a summary in out |
ubereats_update_ledger | new group-order debts | debts.csv and names.csv. Needs confirm: true |
ubereats_dump_cookie | the live Safari session | a mode-600 cookie file. Needs confirm: true, macOS only |
- Start with
ubereats_list_orders, then fetch the receipts that you want. - The ledger counts only your own group orders that were not canceled, and it leaves out your share. A rerun does not add a debt twice.
- Amounts are item subtotals. They do not split delivery fees or discounts.
- Use absolute
outandcsv_dirpaths. The defaults (./ue_receipts_out,./ue_ledger) are relative to the working directory of the MCP server.
Configuration
The tools look for a session in this order: the cookie_file argument, the Safari cookie jar, then ~/.config/ubereats/cookie.txt. On Linux, put a raw Cookie header in that file.
| Variable | Sets | Default |
|---|---|---|
UBEREATS_MCP_MAX_STRING_CHARS | longest string in a result | 20000 |
UBEREATS_MCP_MAX_TOTAL_CHARS | largest result | 120000 |
UBEREATS_FORCE_PLATFORM | platform for registration tests only | the real platform |
If macOS blocks the Safari cookie jar, give the MCP host Full Disk Access or pass cookie_file. Cookies are credentials, so keep them out of any repository.
How it works
The Bun MCP server registers the tools that the host can run, and it hides the rest with a reason on stderr. Each call runs a Python script under uv. The scripts call the internal Uber Eats web APIs with your browser session.
Limits
- The internal APIs can change at any time.
- An expired session can return an empty list instead of HTTP 401. Log in again before you trust an empty result.
- The cookie export needs macOS. The other 3 tools also work on Linux.
For AI agents
Facts for coding agents and LLM tools. The rules for changing the code are in AGENTS.md.
- Summary: Claude Code and Codex plugin with 4 MCP tools for Uber Eats order history, receipts, a group-order debt ledger and Safari cookie export.
- Type: plugin
- Interfaces: MCP
ubereats(stdio,dist/server.js). Python scripts inscripts/run under uv. - Install:
claude plugin install ubereats@zyx1121, afterclaude plugin marketplace add zyx1121/marketplace - Run: the host starts the MCP server
- Verify: call
ubereats_list_orderswith a live session and an absoluteoutpath - Config:
UBEREATS_MCP_MAX_STRING_CHARS,UBEREATS_MCP_MAX_TOTAL_CHARS, and acookie_fileargument - Secrets: the Uber Eats session cookie, in Safari or in
~/.config/ubereats/cookie.txt - Limits: no ordering or payment. An empty list can mean an expired session.
Development
bun install --frozen-lockfile
bun run check
claude plugin validate .
The tests run offline with synthetic results and fake executables. They never touch a real account or personal files.