amazon-orders-mcp 1.0.0

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 read-only tools for your Amazon account, available from Claude and any other MCP client.

The server never signs in itself, and never sees your credentials. Instead, it reuses the session amazon-orders saves when you sign in on Amazon's own page, in a browser window.

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. First, sign in once from a terminal:

uvx --from "amazon-orders[browser]" amazon-orders login --browser

Run this again whenever the session expires (your assistant will tell you when it has). Then add the server to your MCP client.

For Claude Code:

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

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

For any other client configured with JSON:

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

That's it! Your assistant can now answer questions about your Amazon account.

If you'd rather not use uv, amazon-orders-mcp can also be installed and/or upgraded using pip:

pip install amazon-orders-mcp --upgrade

Then use amazon-orders-mcp as the command, and sign in with amazon-orders login --browser.

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.

Configuration

The server uses the same config as the amazon-orders CLI, so settings such as the Amazon site (e.g. amazon.co.uk) are set in AmazonOrdersConfig. 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!