Amazon Order History CSV Download

You can use this MCP server to download your Amazon order history as CSV files. It supports orders, items, shipments, and transactions exports across 16 regional sites, enabling flexible date ranges and browser-based extraction for reliable results.

How to use

After you configure a compatible MCP client, you can request exports through your assistant. You can ask for a full orders export, item-level details, shipment tracking data, or payment transactions, all organized as CSV files. Exportes can be filtered by year, a specific date range, or by recent months. Use it across supported regions to gather data for tax, expense tracking, accounting, or audits.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Clone the project and install dependencies.

Build the project and install browser automation tooling used for data extraction.

Additional sections

Configuration: specify the MCP server as a local stdio process so your client can start it when needed.

Configuration example

{
  "mcpServers": {
    "amazon_orders": {
      "command": "node",
      "args": ["/path/to/amazon-order-history-csv-download-mcp/dist/index.js"]
    }
  }
}

Notes

The server can be started as a local process that your MCP client launches. Ensure the path to the built index file is correct for your environment, and that any required dependencies are installed before starting. If you run into timeout issues, you may need to adjust client timeouts or use smaller export batches.

Security and best practices

Use region-specific exports to minimize data transfer, and authenticate your browser session before running exports to ensure full access to order data.

Troubleshooting

If you encounter timeouts or slow extractions, verify that you are exporting smaller batches, check that your client timeout settings permit longer runs, and confirm that the browser automation components can access the regions you need.

Development

You can run the project in development mode, execute tests, and type-check to ensure the server behaves as expected.

Available tools

get_amazon_orders

Fetch orders with optional items/shipments for a given region and date range.

get_amazon_order_details

Retrieve full details for a specific order by its ID.

get_amazon_transactions

Fetch all payment transactions from the transactions page.

get_amazon_gift_card_balance

Get current balance and recent gift card activity.

get_amazon_gift_card_transactions

Get detailed gift card activity and history.

check_amazon_auth_status

Verify if the browser session is authenticated for the region.

export_amazon_orders_csv

Export a fast summary of orders to CSV.

export_amazon_items_csv

Export item-level details for orders to CSV.

export_amazon_shipments_csv

Export shipment and tracking information to CSV.

export_amazon_transactions_csv

Export payment transaction details to CSV.

export_amazon_gift_cards_csv

Export gift card activity to CSV.