ubereats

English | 繁體中文 | 简体中文

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.csv and keeps paid states, dates, notes and real names.

• Exports a Safari session: writes the live cookie to a mode-600 file, on macOS.

Related MCP server: sharebite-mcp

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

• 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 out and csv_dir paths. 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.

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 in scripts/ run under uv.

• Install: claude plugin install ubereats@zyx1121, after claude plugin marketplace add zyx1121/marketplace

• Run: the host starts the MCP server

• Verify: call ubereats_list_orders with a live session and an absolute out path

• Config: UBEREATS_MCP_MAX_STRING_CHARS, UBEREATS_MCP_MAX_TOTAL_CHARS, and a cookie_file argument

• 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.

License

MIT