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.

| 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. |

| 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) |

npm ci

node dist/index.js

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

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"
      }
    }
  }
}

On