Amazon Cart MCP Server

Local MCP (Model Context Protocol) server that enables AI assistants to interact with your personal Amazon cart through browser automation. Works with Claude Desktop, Poke, and any MCP-compatible client.

⚠️ Important Disclaimer

This tool uses browser automation to interact with Amazon.com.

• Users are solely responsible for ensuring their use complies with Amazon's Terms of Service
• This project is for personal, educational use only - not for commercial automation or reselling
• Use at your own risk - the authors assume no liability for any violations of Amazon's policies or consequences thereof
• Not affiliated with Amazon - this is an independent, unofficial tool
• Amazon may change their website or policies at any time, potentially breaking functionality
• Excessive automation may result in account restrictions or bans

By using this software, you acknowledge and accept these risks.

Features

• 🔍 Search Amazon - Find products by search query
• 🛒 Add to Cart - Add items to your Amazon cart automatically
• 👀 View Cart - Check current cart contents and subtotal
• 🔐 Login Persistence - Session saved locally for seamless use
• 🌐 Secure Access - Bearer token authentication via ngrok tunnel

Quick Start

Prerequisites

• Node.js v20 or higher
• npm or yarn
• ngrok account (free tier works)

Installation

1. Clone the repository:

   git clone https://github.com/madebydia/amazon-mcp-server.git
   cd amazon-mcp-server
   

2. Install dependencies:

   npm install
   

3. Configure environment:

   cp .env .env.local  # Optional: keep your settings separate
   

   Edit .env and set:

   • AUTH_TOKEN - Generate a secure random token (required)
   • HEADLESS=false - For first-time login
   • AMAZON_DOMAIN=amazon.com - Or your local Amazon domain

4. Build the project:

   npm run build
   

5. Start the server:

   npm start
   

6. First-time login:

   • A Chrome browser window will open
   • Log into your Amazon account manually
   • Session will be saved in ./user-data/
   • After logging in once, you can:
     • Stop the server (Ctrl+C)
     • Set HEADLESS=true in .env
     • Restart with headless mode

7. Expose via ngrok (in a separate terminal):

   npm run tunnel
   # Note the HTTPS URL (e.g., https://abc123.ngrok.io)
   

Connecting to Poke

1. Copy your ngrok URL from the terminal

2. In Poke, add a custom MCP integration:

   • URL: https://your-ngrok-url.ngrok.io/sse
   • API Key: Your AUTH_TOKEN from .env
   • Type: MCP Server

3. Important: Always use the /sse endpoint!

4. Test the connection by asking Poke:

   • "What tools do you have?"
   • "Search Amazon for wireless mouse"

Connecting to Claude Desktop

1. Build the project: npm run build
2. Open Claude Desktop → Settings → Developer → Edit Config
3. Add to mcpServers:

{
  "mcpServers": {
    "amazon-cart": {
      "command": "node",
      "args": ["/absolute/path/to/amazon-mcp-server/dist/server.js"],
      "env": {
        "AUTH_TOKEN": "your-token-here",
        "HEADLESS": "true",
        "AMAZON_DOMAIN": "amazon.com"
      }
    }
  }
}

4. Restart Claude Desktop
5. You should see the Amazon tools available in the tools menu (🔧)

First-time setup: Run the server once with HEADLESS=false to log into Amazon manually. After that, set HEADLESS=true for Claude Desktop.

Available Tools

... View full README on GitHub