Skip to main content
Glama

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GraysonCAdams/alexa-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server