alexdlaird/amazon-orders-mcp

and transactions, built on amazon-orders. It gives your AI assistant
tools for your Amazon account, available from Claude and any other 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:
### Claude
Claude Desktop: download amazon-orders-mcp- .mcpb from the
latest release and open it.
Claude Code:
sh
claude mcp add amazon-orders -- uvx amazon-orders-mcp
### 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:
sh
codex 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:
json
"mcpServers": {
"amazon-orders": {
"command": "uvx",
"args": ["amazon-orders-mcp"]
### Remote Clients
For clients that connect to a server instead of running one, the server can also serve
Streamable HTTP:
sh
uvx amazon-orders-mcp --transport streamable-http
It listens at http://127.0.0.1:8000/mcp. See --help to change that, or to require a bearer token (required off
loopback). On a server without a display, signin can't open a browser window, so sign in there first with
uvx amazon-orders login, which asks for your username and password instead.
### Docker
sh
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 |
| signin | Opens a browser window for you to sign in to Amazon, when you ask |
| getorders | A batch of orders by year, time filter or order type, optionally detailed |
| searchorders | A batch of items by product, order number, address or recipient, any year |
| getorder | One order, by order number |
| gettracking | A shipment's carrier and tracking number, from an order's shipment ID |
| getinvoices | An order's printable summary, and any invoice PDFs the seller issues |
| gettransactions | A batch of payment transactions over a number of days, or for an order |
| getgiftcards | The Gift Card balance, with a batch of its activity over a number of days |