amazon-orders-mcp - An MCP server for Amazon order history, line items, and transactions¶

https://img.shields.io/pypi/v/amazon-orders-mcp

https://img.shields.io/pypi/pyversions/amazon-orders-mcp.svg

https://img.shields.io/github/actions/workflow/status/alexdlaird/amazon-orders-mcp/build.yml

https://img.shields.io/readthedocs/amazon-orders-mcp

https://img.shields.io/github/license/alexdlaird/amazon-orders-mcp

amazon-orders-mcp is an unofficial MCP server for Amazon order history, line items, and transactions, built on amazon-orders. It gives your AI assistant tools for your Amazon account, available from any MCP client.

The server never sees your credentials. When you sign in, a browser window opens on Amazon’s own page, and the server reuses the session that leaves behind. It also runs on a server without a display, where you sign in from a terminal instead (see Remote Clients).

Note

This server reads its data through amazon-orders, which works by parsing data from Amazon’s consumer-facing website. As Amazon provides no official API to use, older versions may break at any time, so it’s recommended that you use the latest version.

Installation¶

amazon-orders-mcp is available on PyPI and is run with uvx, so there’s nothing to install up front. Add it to your AI assistant:

ChatGPT¶

ChatGPT Desktop: in Settings → Plugins, add an MCP server of type STDIO, with uvx as the command and amazon-orders-mcp as its argument.

Codex:

codex mcp add amazon-orders -- uvx amazon-orders-mcp

Claude¶

Claude Desktop: download amazon-orders-mcp-<version>.mcpb from the latest release and open it.

Claude Code:

claude mcp add amazon-orders -- uvx amazon-orders-mcp

Other Clients¶

Any client that runs local MCP servers can use this JSON, or amazon-orders-mcp as the command if you’ve installed it with pip install amazon-orders-mcp:

{
  "mcpServers": {
    "amazon-orders": {
      "command": "uvx",
      "args": ["amazon-orders-mcp"]
    }
  }
}

For clients that connect to a server instead of running one, see Remote Clients.

Docker¶

docker build -t amazon-orders-mcp .
docker run -i --rm -v amazon-orders:/home/app/.config/amazonorders amazon-orders-mcp

A container has no display, so sign in with the login target first. See the Dockerfile for how.

Basic Usage¶

Just ask your assistant about your orders, and it will use the following tools:

Tool	Returns
`sign_in`	Opens a browser window for you to sign in to Amazon, when you ask
`get_orders`	A batch of orders by year, time filter or order type, optionally detailed
`search_orders`	A batch of items by product, order number, address or recipient, any year
`get_order`	One order, by order number
`get_tracking`	A shipment’s carrier and tracking number, from an order’s shipment ID
`get_invoices`	An order’s printable summary, and any invoice PDFs the seller issues
`get_transactions`	A batch of payment transactions over a number of days, or for an order
`get_gift_cards`	The Gift Card balance, with a batch of its activity over a number of days
`get_prime_payments`	Prime membership fee charges, each with its order number
`check_session`	Whether you’re signed in, on each Amazon site you have a session for
`get_config`	The settings your assistant can change, and their values
`update_config`	Changes one of those settings

Order history and transactions come back in batches of limit results (25 by default, and a batch can run up to a page over), with a cursor your assistant passes back to get the next batch.

Every tool that reads Amazon takes an optional site, like amazon.de, so your assistant can read each Amazon site you shop on from one server, e.g. “my last amazon.de orders”. Without it, tools read your default site, the domain setting. Each site has its own sign-in, so ask your assistant to sign you in to each one.

Configuration¶

Ask your assistant to change a setting, such as the default Amazon site (e.g. amazon.co.uk) or the browser to sign in with. Settings are shared with the amazon-orders CLI, so it follows the same changes. See Supported Sites for the sites amazon-orders can read.

Dive Deeper¶

For more on the data the server returns, see the amazon-orders documentation, including the Order entity’s fields and troubleshooting.

Contributing¶

Want to contribute financially? If you’ve found amazon-orders-mcp useful, sponsorship would be greatly appreciated!