Which integrations are available for this server?

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.

How do I use Alexa Home Automation MCP Server?

1. Click on "Install 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 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.

Alexa Home Automation MCP Server 🏠🔋

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.

License: MIT MCP

✨ Features

📢 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.

🚀 Getting Started

1. Requirements

pnpm installed.
An Amazon account with connected Alexa devices.

We've automated the tedious process of collecting Amazon cookies.

Install dependencies:
pnpm install
Run the cookie automation script:
pnpm run get-cookies
A 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.

3. Local Development

Start the server in Node.js mode:

pnpm run dev:node

The server will be available at http://localhost:3001.

🛠️ MCP Configuration

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" } } } }

🏗️ Architecture

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.