alexa-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ALEXA_MCP_AUTH_DIR | No | Path to a directory containing auth.json for multi-instance support. If not set, defaults to .auth-data/ in the project directory. |
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_commandA | Send a text command to Alexa as if you spoke it. Example: "enciende las luces de la cocina" |
| 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_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 18 tools
Every tool targets a distinct action and resource. The 'list_' tools are clearly differentiated by object (devices vs groups vs lists vs routines vs smarthome_devices), and all other tools have unique purposes (announce vs speak_ssml vs text_command, etc.), leaving no ambiguity.
All tool names follow the consistent pattern 'alexa_verb_noun' in snake_case. Verbs are descriptive (add, get, list, create, delete, set, etc.) and multi-word verbs are hyphenated appropriately (do_not_disturb, text_command). No mixing of conventions.
18 tools is well-scoped for a server covering voice announcements, smart home control, list management, routines, and device configuration. Each tool serves a necessary function without redundancy, fitting the typical 3-15 range slightly above but still reasonable.
The tool surface covers the main Alexa domains: CRUD for lists (add/get but missing delete/update), groups (full CRUD), devices (list, query, volume), routines (list/execute but no create/edit/delete), and voice actions (announce, SSML, text command). Minor gaps like list item deletion exist, but core workflows are complete.