This Amazon Cart MCP Server exposes tools that let an AI assistant interact with your personal Amazon cart via browser automation. It supports searching for products, adding items to your cart, viewing the cart contents, and checking login status. The server is designed to be used with MCP-compatible clients such as Poke and Claude Desktop, and can be exposed securely through ngrok. After starting, clients can connect to the /sse endpoint to exchange structured MCP actions and responses. Use the provided tools in Poke to query, add items, or verify login before attempting cart operations.

Prerequisites:

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

Installation steps:

1. Clone the repository: git clone https://github.com/meimakes/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 token (required)
   • HEADLESS: false for first-time login
   • AMAZON_DOMAIN: amazon.com (or your locale domain)
   • PORT: 3000 (or your preferred port)
   • USER_DATA_DIR: ./user-data (Chrome session data)

4. Build the project: npm run build

5. Start the server: npm start

6. Enable ngrok tunneling (in a separate terminal): npm run tunnel

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

7. Connect clients (Poke or Claude Desktop) using the exposed /sse endpoint and the AUTH_TOKEN for authentication.

Tips and troubleshooting:

• Ensure AUTH_TOKEN is kept secret and rotated periodically.
• The server uses Puppeteer to automate a Chrome session; HEADLESS=false is needed for the initial manual login to save a session in ./user-data.
• Expose the server securely with ngrok or other tunneling; always use HTTPS endpoints when exposed publicly.
• If tools aren’t visible in Poke, restart the server, verify the ngrok tunnel is active, and check server logs for tool discovery events.
• Environment variables are defined in .env; never commit this file to version control.
• The /sse endpoint is the primary communication channel for MCP interactions.
• For Claude Desktop integration, you may need to point to the dist/server.js with proper environment variables set for HEADLESS and AMAZON_DOMAIN.