alexa-mcp

alexa-mcp

An MCP server that enables users to manage their Amazon Alexa shopping lists directly from MCP clients like Claude. It provides tools for listing, adding, updating, and deleting shopping list items through secure Amazon account authentication.

Category
Visit Server

README

alexa-mcp

MCP server for Amazon Alexa -- manage your Alexa shopping list from any MCP client (Claude, etc.).

Built on the Model Context Protocol and the alexa-remote2 library.

Tools

Tool Description
authenticate Authenticate with your Amazon account. Uses a saved cookie if available, otherwise starts a browser login proxy and returns a URL to open.
list_items Get items from your Alexa shopping list. Optionally include completed items.
add_items Add one or more items to your Alexa shopping list.
delete_items Delete items from your Alexa shopping list by name (case-insensitive match).
update_item Update an item on your shopping list -- rename it and/or change its completion status.
complete_items Mark items as completed on your Alexa shopping list by name (case-insensitive match).
check_status Check whether the server is authenticated and show current configuration.

Environment Variables

Variable Default Description
COOKIE_PATH ~/.alexa-mcp/cookie.json Path to the persisted Alexa authentication cookie
AMAZON_PAGE amazon.com Amazon domain to authenticate against
PROXY_PORT 3001 Port for the browser login proxy (used during initial authentication)
ALEXA_COOKIE -- Pre-seeded cookie JSON (alternative to COOKIE_PATH file)

Setup

npm ci

Usage

Stdio mode (direct)

node dist/index.js

HTTP mode (via mcp-proxy)

mcp-proxy --port 8005 -- node dist/index.js

Claude Desktop configuration

Add this to your Claude Desktop MCP config:

{
  "mcpServers": {
    "alexa": {
      "command": "node",
      "args": ["/path/to/alexa-mcp/dist/index.js"],
      "env": {
        "COOKIE_PATH": "/path/to/cookie.json"
      }
    }
  }
}

Authentication

On first run, the authenticate tool starts a local proxy server. Open the returned URL in your browser and log in to your Amazon account. The cookie is saved to COOKIE_PATH and reused for subsequent sessions.

If you already have a cookie (e.g., from a previous session or another machine), you can either:

  • Place the JSON file at COOKIE_PATH
  • Set the ALEXA_COOKIE environment variable with the JSON content

Patches

This project includes a patch for alexa-cookie2 (applied automatically via patch-package on npm ci) that improves resilience when the Amazon user-data endpoint returns unexpected responses.

License

MIT -- see LICENSE.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured