All notable changes to smart-speaker-mcp will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
First public release. Major cleanup that removes a non-working Alexa integration and collapses a duplicated tool surface into a single clean API.
- All Alexa support. Amazon retired the Pre-built Routines API on 2026-05-13 and stopped accepting new AVS product registrations earlier, so no third-party path can reliably control existing Echo devices via this codebase's original architecture. Voice Monkey was evaluated as an alternative but rejected for v4.0 to keep the project dependency-free; it may return as an optional plugin later.
- All
alexa_*MCP tools (alexa_play_music,alexa_pause,alexa_resume,alexa_stop,alexa_set_volume,alexa_get_status,alexa_discover_devices,alexa_auth,alexa_auth_complete). AlexaConfigstruct and theAlexafield onConfig.- All
ALEXA_*andVOICEMONKEY_*environment variable overrides. device_typeconfig field — there's only one supported backend now.SMART_SPEAKER_DEVICE_TYPEenv var.- The
smart_*tool family (duplicatedgh_*). - The
gh_*tool family (its features are now in the unprefixed names).
-
Tool naming. Replaced 14 tools with a single clean 10-tool API. Migration:
Old New gh_discover_devicesdiscover_devicesgh_play_music,smart_playplaygh_pause,smart_pausepausegh_resume,smart_resumeresumegh_stop,smart_stopstopgh_set_volumeset_volumegh_get_statusget_statuslist_local_musiclist_local_music(unchanged)get_config/set_configget_config/set_config(unchanged, simpler schema) -
set_configno longer acceptsdevice_type,alexa_client_id,alexa_client_secret,voicemonkey_token,default_speaker_device, orroutine_map. -
Default
MusicDiris now~/Music(was~/sundar/songs).
CHANGELOG.md(this file).- Build flag
-X main.version=...so the version reported by the MCP server matches the release tag.
setup.commandnow runsgo vet ./...before building, catching syntax and import errors immediately instead of in the middle ofgo build.
Pre-release iterations — not published. See git history for the development trail.