MCP server

Control your Alexa smart plugs from any assistant.

A self-hosted Model Context Protocol server that turns Amazon Echo smart plugs on and off, reads their state, and lists what is connected. Link your Amazon account once, point your assistant at the endpoint, and it can run the plugs for you.

Step 1

Connection

Checking status…

Step 2

Endpoint

Add this URL to your assistant as a remote MCP server. It speaks JSON-RPC 2.0 over streamable HTTP. If you set MCP_BEARER_TOKEN, send it as a bearer token.

/api/mcp

Available

Tools

list_plugsargs: none
List every smart plug with its current power state and reachability.
get_plug_statusargs: plug
Read a single plug's on/off state and whether it is online.
turn_plug_onargs: plug
Turn a smart plug on.
turn_plug_offargs: plug
Turn a smart plug off.
toggle_plugargs: plug
Flip a plug to the opposite of its current state.

Setup

Self-hosting

Create a Login with Amazon security profile in the Amazon Developer console with the smart-home control scope, then set these on the server before linking your account:

ALEXA_CLIENT_IDLogin with Amazon client id
ALEXA_CLIENT_SECRETLogin with Amazon client secret
ALEXA_REDIRECT_URIhttps://your-host/api/auth/alexa/callback
MCP_BEARER_TOKENOptional shared secret for the MCP endpoint

Tokens are stored server-side and refreshed automatically, so you link the account once. Disconnecting clears the stored credentials.