Amazon Orders
io.github.alexdlairdPublished by GitHub account alexdlairdv1.2.0Updated Oct 24, 2026
An MCP server for Amazon order history, line items, and transactions, built on amazon-orders
Overview
Unofficial local MCP server that lets an assistant read your Amazon order history, line items, tracking, invoices and transactions.
- What you can do
- Sign in to Amazon sites and check which sessions are active
- List, search and fetch orders by year, time filter, order type, product, order number, address or recipient
- Get shipment carrier and tracking numbers, plus printable order summaries and seller invoice PDFs
- Read payment transactions, Gift Card balance and activity, and Prime membership charges
- Read and change the server's own settings, such as the default Amazon site
- When to use it
- Useful when you want to ask an assistant about your own Amazon purchases — recent orders, where a shipment is, what an order cost, Gift Card balance or Prime fees — across the Amazon sites you shop on, without exporting data by hand.
- Requirements
- Runs locally via uvx (or pip) as a stdio process; Python tooling and a desktop session for the browser sign-in, or a terminal login on headless machines. Optional Streamable HTTP mode listens on loopback by default. No API keys or environment variables are declared; sign-in happens on Amazon's own page and the session is reused.
Installation
In SourceWeft
- Open Amazon Orders in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
[amazon-orders-mcp - An MCP server for Amazon order history]
[Version] [Python Versions] [Build] [GitHub License]
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:
Claude
Claude Desktop: download amazon-orders-mcp-<version>.mcpb from the
latest release and open it.
Claude Code:
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:
Remote Clients
For clients that connect to a server instead of running one, the server can also serve 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, sign_in 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
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:
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.
Documentation
For more on the data the server returns, amazon-orders's official documentation is available
at Read the Docs, 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!
Source: README.md at commit 4fd6fa6
Tools
0Version history
1- v1.2.0LatestOct 15, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts