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.
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_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.
Recommended Servers
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.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.