alexa-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port used by npm run serve (Streamable HTTP / SSE) | 8000 |
| ALEXA_PROXY_PORT | No | Local port used exclusively during npm run auth | 3457 |
| ALEXA_AMAZON_PAGE | No | Amazon marketplace host (e.g., amazon.co.uk, amazon.de, amazon.com.mx) | amazon.com |
| ALEXA_MCP_AUTH_DIR | No | Path to store auth.json (supports ~/ expansion) | .auth-data/ |
| ALEXA_PROXY_LANGUAGE | No | Proxy language parameter (e.g., en_GB, de_DE, es_MX) | en_US |
| ALEXA_ACCEPT_LANGUAGE | No | Preferred HTTP Accept-Language header (e.g., en-GB, de-DE, es-MX) | en-US |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| alexa_list_devicesA | List all Amazon Echo devices in your account with their serial numbers, types, and online status. |
| alexa_list_smarthome_devicesB | List all smart home devices registered in Alexa (lights, switches, sensors, etc). |
| alexa_list_groupsA | List all smart home groups/rooms configured in Alexa. Shows which devices are assigned to each group. |
| alexa_announceB | Send a voice announcement to a specific Echo device. The message will be spoken aloud. |
| alexa_text_commandB | Send a text command to Alexa as if you spoke it. Example: "turn on the kitchen lights" |
| alexa_set_volumeA | Set the volume of a specific Echo device (0-100). |
| alexa_get_volumesA | Get the current volume levels of all Echo devices. |
| alexa_list_routinesA | List all Alexa routines configured in the account. Shows routine names, triggers, and actions. |
| alexa_execute_routineA | Execute an existing Alexa routine by providing its automation definition (from alexa_list_routines). |
| alexa_list_listsA | Get all Alexa lists (shopping lists, to-do lists, custom lists). |
| alexa_get_list_itemsA | Get all items from a specific Alexa list. |
| alexa_add_list_itemB | Add an item to an Alexa list (shopping, to-do, etc). |
| alexa_do_not_disturbA | Enable or disable Do Not Disturb on a specific Echo device. |
| alexa_query_deviceA | Query the current state of one or more smart home devices (on/off, brightness, temperature, etc). |
| alexa_speakA | Make Alexa speak plain text directly on a specific Echo device using native text-to-speech (no announcement chime). |
| alexa_speak_ssmlC | Make Alexa speak using SSML (Speech Synthesis Markup Language) for advanced voice control. |
| alexa_update_groupA | Update an existing Alexa smart home group/room. Sets the name and full list of appliance IDs. |
| alexa_create_groupA | Create a new Alexa smart home group/room with a name and optional list of appliance IDs. |
| alexa_delete_groupB | Delete an Alexa smart home group/room. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Tools mostly target distinct resources/actions; however the three speaking tools (alexa_announce, alexa_speak, alexa_speak_ssml) plus alexa_text_command create some overlap in output modality. Descriptions clarify differences (chime vs TTS vs SSML vs simulated command), so an agent can usually distinguish them, but confusion is possible.
All tools use the alexa_ snake_case prefix and typically follow verb_noun (list_devices, set_volume, create_group). Minor deviations (alexa_announce, alexa_text_command, alexa_do_not_disturb) are still readable and consistent enough.
19 tools is slightly above the ideal 3-15 range, but the breadth of Alexa's domain (devices, smart home, groups, routines, lists, TTS, DND) justifies most tools. No excessive redundancy, though some consolidation could be possible.
Core workflows for announcements, routines, volume, groups, and querying are covered, but list management lacks update/delete/remove-item operations, and there is no direct set-device-state tool for smart home control (only natural-language alexa_text_command). These are notable gaps an agent must work around.