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