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.

1. Install dependencies:

   pnpm install
   

2. Run the cookie automation script:

   pnpm run get-cookies
   

3. A local proxy will start. Complete the login in the browser window that appears.
4. 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!

📄 License

MIT © guitarbeat