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.

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

2. Authentication (Automated Cookie Collection)

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.

☕ Support

If you find this project helpful, consider buying me a coffee!

Alexa Home Automation MCP Server