CartClaw
Integrates with the user's own Amazon account to read order history and return deadlines, look up products by ASIN, view and modify the cart, and request checkout approval. It can open Amazon's checkout review page and, only after explicit user approval, place the order after rechecking that the total, items, address, and card still match.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CartClaw what can I still return, soonest deadline first?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CartClaw
Let your AI agent use your own Amazon account: read orders and return deadlines, look up products, fill the cart. It can only buy after you click Place order on an approval page. cartclaw.dev
Not affiliated with or endorsed by Amazon. Amazon is a trademark of Amazon.com, Inc.
Everything runs on your machine. The agent drives a separate browser window with its own profile, signed in to your account once. No Amazon password or session leaves your computer, and your everyday browser is never touched.
What the agent can do
Tool | Does |
| Order history ( |
| Items you can still return, soonest deadline first |
| Title, price and availability for an ASIN |
| What is in the cart |
| Change the cart |
| Ask you to approve buying the cart |
| Whether you approved and the order went through |
There is no tool that places an order.
Related MCP server: Amazon Cart MCP Server
How buying works
The agent fills the cart and calls
checkout_request.The server opens Amazon's checkout review page in its window and reads the total, items, address, card and delivery date. Nothing is placed.
An approval page opens in your normal browser with those details, a screenshot of Amazon's page, and two buttons: Place order and Don't buy. If the card is wrong, pick another saved card and click Use this card: the server switches it on Amazon's checkout and the page shows the new total.
If you click Place order, the server reloads checkout, switches back to the card you approved (Amazon puts its default card back whenever checkout reopens), checks that the total, items, address and card still match what you saw, and only then clicks Amazon's "Place your order". If anything changed, nothing is ordered.
The request expires after 15 minutes. A newer request replaces an older one.
Setup
Needs uv, git, and Brave, Chrome, Edge or Chromium.
Sign in to Amazon once. A window opens; tick Keep me signed in:
uvx --from git+https://github.com/ucsandman/cartclaw cartclaw loginAdd it to Claude Code:
claude mcp add --scope user cartclaw -- uvx --from git+https://github.com/ucsandman/cartclaw cartclaw
Other MCP clients can run the same uvx command as a local stdio server.
The browser window starts by itself when a tool needs it and stays open between sessions. You can minimize it.
Optional settings (environment variables): CARTCLAW_BROWSER (browser path), CARTCLAW_PROFILE (profile folder, default ~/.cartclaw/profile), CARTCLAW_CDP_PORT (default 9333).
Development
git clone https://github.com/ucsandman/cartclaw && cd cartclaw && uv sync. The marketing site at cartclaw.dev is static HTML plus one Vercel function in site/.
Site operations (2026-10-02):
A push to
maindeploys the site. The Vercel project's root directory issite.Google Search Console and Bing verify through the
google-site-verificationandmsvalidate.01meta tags insite/index.html. Removing either tag revokes that verification.Vercel Web Analytics loads from
/_vercel/insights/script.json every page.Pro waitlist signups are stored as private files in the Vercel Blob store
cartclaw-waitlist.uv run pytest: parsers against saved Amazon pages (personal details scrubbed), the approval page, and the tool list. No network.uv run python scripts/live_smoke.py: read-only check against your real account over the MCP protocol.
Limits
amazon.com (US) only.
Returns: return deadlines are read, but starting a return is not built yet.
The approval page lists saved cards only. To pay with a bank account or gift card balance, select it in the Amazon window first.
The approval gate stops the agent from buying through this server. It is not a sandbox: an agent with shell access to your machine could drive the browser's control port directly.
Automating your account may break Amazon's Conditions of Use. You are the one accessing your account, but Amazon can still act on it.
Amazon changes its pages. When a parser breaks, the tool says what it could not read instead of guessing.
Order history parsing uses amazon-orders (MIT).
Available Tools
8 toolscartARead-only
What is in the cart now, with the subtotal.
Inputs: no named parameters. Returns: object
cart_addB
Add a product to the cart (one-time purchase, not Subscribe & Save). Returns the cart.
Inputs: asin (required), quantity. Returns: object
cart_removeB
Remove a product from the cart. Returns the cart.
Inputs: asin (required). Returns: object
checkout_requestA
Ask the user to approve buying the current cart. Opens Amazon's checkout review (nothing is placed), then an approval page in the user's browser showing total, items, address and card. Returns at once with status 'pending'; poll checkout_status. The user can approve or decline.
Inputs: no named parameters. Returns: object
checkout_statusARead-only
Where an approval stands: pending, switching (the user is changing the card), placing, placed (with order_number), rejected, expired, superseded or failed (with detail).
Inputs: approval_id (required). Returns: object
ordersARead-only
Order history with each item's return window. period: 'last30', 'months-3' or 'year-YYYY'. Amazon shows 10 orders per page; max_pages caps how many pages are read.
Inputs: period, max_pages. Returns: object
productARead-only
Title, price and availability for one product by ASIN (e.g. from orders).
Inputs: asin (required). Returns: object
returnable_itemsARead-only
Items from the last 3 months whose return window is still open, soonest deadline first.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a distinct purpose: orders (history) vs returnable_items (open-window filter), product (lookup), cart/cart_add/cart_remove (view/add/remove), and checkout_request vs checkout_status (initiate vs poll). No two tools overlap in a way that would cause misselection.
Mostly noun-based names with clear grouping: cart_ prefix for cart mutations and checkout_ prefix for the two-phase approval flow. Minor inconsistency in that orders is plural while product and cart are singular, but the convention is readable and predictable.
Eight tools is well-scoped for a shopping/checkout assistant, covering the full browse-to-purchase flow without redundancy. Every tool earns its place.
Core lifecycle is covered: order history, returns, product info, full cart CRUD, and a two-phase checkout with status polling. Minor gaps exist (no product search beyond ASIN, no cart quantity update), but agents can work around these via existing tools.
Related MCP Connectors
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Connect AI agents to your own Chrome with scoped access, approvals, and verified task results.
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
Your own browser in the cloud, logged in to your sites, shared by you and your AI.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search products, manage shopping carts, place orders, and retrieve order history from Amazon and Target accounts.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with your personal Amazon cart through browser automation, allowing search, add to cart, and view cart functionalities.22MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to search products, manage cart, place orders, and track shipments on Amazon via browser automation.22 npm2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to research and shop on Amazon using their own logged-in browser session, supporting product search, details, reviews, cart, wishlist, and order tracking without API keys.MIT