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.com, amazon.co.uk, amazon.de). | amazon.com |
| ALEXA_MCP_AUTH_DIR | No | Path to store auth.json (supports ~/ expansion). Default is .auth-data/. | .auth-data/ |
| ALEXA_PROXY_LANGUAGE | No | Proxy language parameter (e.g., en_US, en_GB, de_DE). | en_US |
| ALEXA_ACCEPT_LANGUAGE | No | Preferred HTTP Accept-Language header (e.g., en-US, en-GB, de-DE). | 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. |
| alexa_smarthome_actionA | Control Alexa smart home devices directly (turn on/off, set brightness, set temperature, lock/unlock). |
| alexa_play_musicA | Search and stream music on an Echo device from Amazon Music, Spotify, Apple Music, TuneIn, iHeartRadio, or Deezer. |
| alexa_play_audibleB | Play an audiobook from Audible on an Echo device. |
| alexa_media_controlC | Control media playback (stop, pause, play, next, previous) on a specific Echo or all devices. |
| alexa_set_equalizerA | Adjust bass, midrange, and treble levels on an Echo speaker (-6 to +6 dB). |
| alexa_set_reminderA | Schedule a spoken reminder on an Echo device at a specific time. |
| alexa_get_notificationsA | List active alarms, timers, and reminders across all Echo devices in the account. |
| alexa_set_alarm_volumeA | Adjust alarm and notification volume level independently from media/music volume. |
| alexa_play_soundA | Play a built-in sound effect or chime on an Echo device (e.g. bells, doorbells, boings, applause, buzzers). |
| alexa_curated_ttsA | Make Alexa speak a randomized built-in phrase from a curated category. |
| alexa_play_behaviorB | Trigger native routine behaviors like weather report, traffic update, flash briefing, jokes, fun facts, or stories. |
| alexa_fire_tv_controlB | Control a Fire TV or Fire TV Cube (turnOn, turnOff, pause, resume, navigateHome). |
| alexa_get_historyA | Retrieve recent voice interaction history (what users said to Alexa, device used, timestamps). |
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 32 tools
Most tools target distinct resources/actions (devices, groups, routines, media, lists), and descriptions clarify edge cases like speak vs announce vs speak_ssml. However, the number of voice/content-related tools (speak, announce, curated_tts, play_behavior, play_sound, play_music) could still cause occasional misselection.
All tools share the alexa_ prefix and snake_case format, with most following a verb_noun pattern (alexa_set_volume, alexa_list_routines, alexa_delete_group). A few exceptions like alexa_text_command, alexa_curated_tts, and alexa_fire_tv_control break the strict pattern but remain readable and predictable.
With 32 tools, this is a very large surface for an MCP server. While the scope is broad, the count exceeds what most agents need and adds selection friction; several tools could likely be consolidated or omitted.
The server covers a wide range of Alexa capabilities: voice output, smart home control, groups, routines, lists, media, alarms/reminders, device settings, and history. Minor gaps exist (e.g., messaging/calling, skill management, multi-room audio), but core Alexa workflows are well represented.