Provides control over Alexa-connected smart home devices through the Alexa API, enabling voice announcements, music control, smart lighting automation, sensor monitoring, and volume management across Echo devices and connected smart home accessories.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Alexa Home Automation MCP Server turn on the living room lights and set them to 50% brightness"
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.
A powerful Model Context Protocol (MCP) server that provides AI agents (like Claude Desktop) with full control over your Alexa-connected smart home.
This server acts as a bridge between the Alexa API and the MCP ecosystem, enabling capabilities like voice announcements, music control, lighting automation, and sensor monitoring.
📢 Voice Announcements: Send customized voice messages to any Alexa device with smart night-time suppression.
🎵 Music Control: Get real-time status of current tracks and playback on your Echo devices.
💡 Smart Lighting: Full control over power, brightness, and colors for all discovered smart lights.
🌡️ Sensor Integration: Access temperature, light, and motion sensor data from your Alexa devices.
🔊 Volume Management: Precise control over volume levels across your entire device fleet.
🤖 Self-Documenting: Clean, descriptive API handlers designed for LLM consumption.
Related MCP server: MCP Home Assistant Server
pnpm installed.
An Amazon account with connected Alexa devices.
We've automated the tedious process of collecting Amazon cookies.
Install dependencies:
pnpm installRun the cookie automation script:
pnpm run get-cookiesA local proxy will start. Complete the login in the browser window that appears.
The script will automatically generate your .env file with the required UBID_MAIN and AT_MAIN tokens.
Create a .env file in the root directory and add your required variables.
# Amazon Authentication (Auto-generated by get-cookies script)
UBID_MAIN="..."
AT_MAIN="..."
# API Configuration
API_BASE="https://alexa.amazon.com"
# Security Configuration
MCP_AUTH_TOKEN="your-secret-token" # Required: Bearer token for authenticating API requests
ALLOWED_ORIGINS="http://localhost,http://127.0.0.1" # Comma-separated list of allowed origins for CORS (default: http://localhost)Start the server in Node.js mode:
pnpm run dev:nodeThe server will be available at http://localhost:3001.
Add this to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"alexa": {
"command": "node",
"args": ["/absolute/path/to/alexa-mcp-server/dist/node-index.js"],
"env": {
"API_BASE": "http://localhost:3001"
}
}
}
}This project is built using:
Hono: A fast, lightweight web framework.
TypeScript: For robust, type-safe development.
MCP SDK: To enable seamless integration with AI agents.
Cloudflare Workers Ready: Can be deployed to Cloudflare or any Node.js environment via Docker.
If you find this project helpful, consider buying me a coffee!
MIT © guitarbeat
This server cannot be deployed
Control your Tesla from your AI assistant - climate, charging, access, and security.
Give your AI agents the tools to build, manage, and run automation workflows.
Give your AI agent a memory and body on your iPhone: set alarms, ring your phone, over MCP.
Manage digital signage screens, playlists and media from your AI assistant.
