Uber Eats

Order history, itemized receipts and group-order debt ledgers through 4 native MCP tools.

An independent plugin for Codex and Claude Code. Ask your agent to perform the task; MCP is the public interface and scripts are the implementation. Extracted from zyx1121/plugin.

Install

Requires Bun (tested with 1.3.13) and uv on the host PATH.

# Claude Code
claude plugin marketplace add zyx1121/marketplace
claude plugin install ubereats@zyx1121

# Codex
codex plugin marketplace add zyx1121/marketplace
codex plugin add ubereats@zyx1121

Restart the client session after installation. The committed dist/server.js bundle needs no bun install in the plugin cache. Both manifests are generated from plugin.json and mcp.json; the marketplace pins release commits.

Use

Ask your agent to list recent orders first, fetch selected receipts, or update an existing group-order ledger. There is no ordering or payment tool.

Tool	Result and side effects
`ubereats_list_orders`	Lists order metadata and writes `index.json` to `out`
`ubereats_fetch_receipts`	Writes receipt JSON, index and summary files to `out`
`ubereats_update_ledger`	Rewrites `debts.csv` and `names.csv`; requires `confirm: true`
`ubereats_dump_cookie`	Exports a live Safari session to a mode-0600 file; requires `confirm: true`

The first three tools work on macOS and Linux with uv. Cookie export requires macOS. Missing dependencies hide the affected tools and are reported on stderr.

Authentication uses, in order: an explicit cookie_file, Safari's binarycookies file if it exists, then ~/.config/ubereats/cookie.txt. On Linux provide a raw Cookie header file. If macOS denies access to Safari's cookie jar, grant the host Full Disk Access or supply cookie_file explicitly. Cookies are credentials; keep them outside this repository. No existing credentials need to move.

These tools use Uber Eats internal web APIs with a browser session. HTTP 401/403 reports rejected credentials; some expired sessions return an empty list instead. An empty list does not establish that there are no orders. Reauthenticate in the browser before relying on that result. The API can change independently of this plugin.

Receipt output defaults to ./ue_receipts_out; ledger output defaults to ./ue_ledger, relative to the MCP server's working directory. Use absolute out and csv_dir paths for persistent storage. Existing ledger rows, paid state, paid dates, notes and real-name mappings are preserved. Only your own uncancelled group orders contribute new debts, excluding your share. Rerunning does not add existing debts again. Amounts are item subtotals; order-list fallback values are estimates and do not allocate delivery fees or discounts.

Migration

Install ubereats@zyx1121 before updating zyx to 0.27.0. Short tool names, parameters, output schemas and confirmation gates are preserved. Claude Code's provider changes from plugin_zyx_utils to plugin_ubereats_ubereats. Remove any manual registration of the same server to avoid duplicates.

Development

bun install --frozen-lockfile
bun run check
claude plugin validate .

Tests are offline: synthetic results, fake executables, isolated bundled MCP sessions and ledger/cookie/receipt regressions. They do not modify live apps, accounts or personal files.

UBEREATS_MCP_MAX_STRING_CHARS and UBEREATS_MCP_MAX_TOTAL_CHARS control output truncation (defaults 20000/120000); the corresponding UTILS_ names remain fallbacks. UBEREATS_FORCE_PLATFORM is a registration-test override and does not emulate another operating system.

src/: MCP schemas, host checks and subprocess execution
scripts/, lib/: domain implementation
dist/server.js: standalone bundled runtime
plugin.json, mcp.json: portable manifests
.claude-plugin/plugin.json, .mcp.json: generated Claude Code compatibility

License

MIT