Which integrations are available for this server?

Supports authentication with Amazon accounts to enable secure access and interaction with Alexa-based services. Provides tools for managing Alexa shopping lists, allowing users to list, add, delete, update, and mark items as completed.

How do I use alexa-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@alexa-mcp add milk, eggs, and bread to my shopping list" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.

Related MCP server: alexa-mcp

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.

Available Tools

7 tools

add_itemsAdd Shopping ItemsB

Add one or more items to your Alexa shopping list.

Inputs: items (required).

authenticateAuthenticate with Amazon AlexaA

Authenticate with your Amazon account. If a saved cookie exists, uses it automatically. Otherwise starts a browser login proxy and returns a URL to open.

Inputs: no named parameters.

check_statusCheck Alexa Connection StatusB

Read-only

Check whether the server is authenticated and show configuration.

Inputs: no named parameters.

complete_itemsComplete Shopping ItemsA

Mark items as completed on your Alexa shopping list by name (case-insensitive match).

Inputs: names (required).

delete_itemsDelete Shopping ItemsA

Destructive

Delete items from your Alexa shopping list by name (case-insensitive match).

Inputs: names (required).

list_itemsList Shopping ItemsB

Read-only

Get items from your Alexa shopping list.

Inputs: include_completed.

update_itemUpdate Shopping ItemA

Update an item on your Alexa shopping list by name (case-insensitive). Can rename and/or change completion status.

Inputs: name (required), new_name, completed.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.8/5.0

Scored 2026-06-26 16:35 across 7 tools

Disambiguation5/5

Each tool targets a distinct action on the shopping list (add, complete, delete, list, update) or authentication/status. No overlap; even complete_items and update_item have clear different purposes (batch complete vs. individual update).

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with underscores (e.g., add_items, check_status). The style is uniform across all 7 tools, making them predictable for an agent.

Tool Count5/5

With 7 tools, the server covers essential shopping list operations and authentication without being too sparse or bloated. The count is well-scoped for the domain.

Completeness4/5

The set covers all basic CRUD actions for shopping list items (create via add_items, read via list_items, update via update_item/complete_items, delete via delete_items) plus authentication. The only minor gap is the lack of a dedicated 'get single item' tool, but listing and name-based operations suffice.

Maintenance

ActivityInactive

ResponsivenessLimited data

Resources

Related MCP Connectors

DataDoe MCP
com.datadoe
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
E-commerce & Retail CRM
216
https://mcp.datadoe.com/mcp/v1
Agent CentralB
to.agentcentral
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Customer Support E-commerce & Retail
9826
https://mcp.agentcentral.to/mcp
Todoist
net.todoist
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
App Automation Workplace & Productivity Project Management
2563
https://ai.todoist.net/mcp
OnlyMCPA
com.only-mcp
Skills, agents and memory in the cloud, plus a gateway to your other MCP servers.
Agent Orchestration Developer Tools Knowledge & Memory
331
https://only-mcp.com/api/mcp

Related MCP Servers

LystBot
App Automation Workplace & Productivity
TourAround
A
license
Not graded
quality
B
maintenance
MCP server that gives AI agents full control over grocery lists, todos, and packing lists. Your AI creates lists, adds items, checks them off, and shares with family/friends.
Updated 4 days ago (2026-11-07 23:39 UTC)
4
MIT
alexa-mcp
Home Automation & IoT App Automation
serversmx
A
license
A
quality
B
maintenance
An MCP server that lets LLMs control Amazon Alexa devices, including announcements, text commands, smart-home group management, routines, and list operations.
Updated 3 days ago (2026-11-09 07:08 UTC)
18
8
MIT
Unofficial AnyList MCP Server
E-commerce & Retail Note Taking
bobby060
A
license
Not graded
quality
A
maintenance
MCP server that integrates with AnyList for managing shopping lists, recipes, and meal planning via natural language.
Updated a month ago (2026-10-05 01:51 UTC)
35
ISC
mcp-amazon
E-commerce & Retail Web Scraping
kogecoo
A
license
Not graded
quality
C
maintenance
A read-only MCP server for accessing Amazon wishlist data via HTML snapshot parsing or optional live browser-backed reads.
Updated 5 months ago (2026-06-11 03:25 UTC)
MIT

alexa-mcp

Tools

Environment Variables

Setup

Usage

Stdio mode (direct)

HTTP mode (via mcp-proxy)

Claude Desktop configuration

Authentication

Patches

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

LystBot

alexa-mcp

Unofficial AnyList MCP Server

mcp-amazon