alexa-cli

---
name: alexa-cli
description: Control Amazon Alexa devices and smart home via the `alexacli` CLI. Use when a user asks to speak/announce on Echo devices, control lights/thermostats/locks, send voice commands, or query Alexa.
homepage: https://github.com/buddyh/alexa-cli
metadata:
  {
    "openclaw":
      {
        "emoji": "🔊",
        "requires": { "bins": ["alexacli"] },
        "env": { "ALEXA_REFRESH_TOKEN": "optional" },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "buddyh/tap/alexacli",
              "bins": ["alexacli"],
              "label": "Install alexacli (brew)",
            },
            {
              "id": "go",
              "kind": "go",
              "module": "github.com/buddyh/alexa-cli/cmd/alexa@latest",
              "bins": ["alexacli"],
              "label": "Install alexa-cli (go)",
            },
          ],
      },
  }
---

# Alexa CLI

Use `alexacli` to control Amazon Echo devices and smart home via the unofficial Alexa API.

## Authentication

```bash
# Browser login (recommended)
alexacli auth

# Non-US accounts
alexacli auth --domain amazon.de
alexacli auth --domain amazon.co.uk

# Check auth status
alexacli auth status
alexacli auth status --verify    # validate token against API

# Remove credentials
alexacli auth logout
```

Token is valid ~14 days. Configuration stored in `~/.alexa-cli/config.json`.

## Devices

```bash
alexacli devices
alexacli devices --json
```

## Text-to-Speech

```bash
# Speak on a specific device
alexacli speak "Hello world" -d "Kitchen Echo"

# Announce to ALL devices
alexacli speak "Dinner is ready!" --announce

# Device name matching is flexible
alexacli speak "Build complete" -d Kitchen
```

## Voice Commands (Smart Home Control)

Send any command as if you spoke it to Alexa:

```bash
# Lights, switches, plugs
alexacli command "turn off the living room lights" -d Kitchen
alexacli command "dim the bedroom lights