Hermes Spotify Skill: skill pack for Hermes Agent

Spotify playback control for Hermes Agent on Linux and Raspberry Pi, built on a small MCP server

What Hermes Spotify Skill does

Hermes Spotify Skill ships a stdio MCP server, spotify_mcp.py, that wraps the spotipy library, plus a SKILL.md of about 1.5 KB. Hermes's built-in MCP client spawns the server at startup, discovers its tools and registers them with an mcp_spotify_ prefix, so no daemon, HTTP service or separate process is needed. The server hides OAuth caching, scope handling, device wake and error mapping inside Python, leaving the agent to choose a tool and fill zero to two arguments, which suits smaller local models.

It exposes 12 tools: play, pause, resume, next_track, previous_track, volume, volume_adjust, shuffle, repeat, queue, now_playing and list_devices. Hermes lists 16 mcp_spotify_ names in its registry because the MCP SDK adds four generic helper entries. The README says it was verified with a local qwen3.6:35b-a3b-nvfp4 model and with Claude Opus 4.7 through OpenRouter, and tested on Raspberry Pi OS Lite Bookworm 64-bit. It also works with raspotify for using a Pi as a speaker.

Key features

12 MCP tools covering playback, volume, shuffle, repeat, queue, now playing and device listing
Stdio MCP server wrapping spotipy, spawned by Hermes's built-in MCP client
SKILL.md of about 1.5 KB, designed for smaller and local models
OAuth cache, scope handling and device wake handled inside the Python server
Setup instructions written so the agent can follow them and ask the user only when needed

When to use it

Controlling music on a Raspberry Pi used as a speaker with raspotify
Asking Hermes by chat or voice to queue a track, adjust volume or skip
Moving playback between devices on a headless Linux machine

Who it is for: Hermes Agent users on Linux or a Raspberry Pi who want to control Spotify by chat or voice.

How it fits with Hermes Agent

A skill plus MCP server for Hermes Agent, installed under ~/.hermes/skills/spotify and registered through Hermes's native MCP client.

How to install Hermes Spotify Skill

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

~/.hermes/hermes-agent/venv/bin/python -m pip install spotipy "mcp[cli]"
git clone https://github.com/Alexeyisme/hermes-spotify-skill.git /tmp/hermes-spotify-skill

Requirements: Linux or Raspberry Pi, a Spotify Premium account, a Spotify Developer app with the redirect URI http://127.0.0.1:8888/callback, and the spotipy and mcp[cli] Python packages in the Hermes venv

Note: Playback control requires a Spotify Premium account.

FAQ

What is Hermes Spotify Skill?

Hermes Spotify Skill is a skill and stdio MCP server that lets Hermes Agent control Spotify playback. It exposes 12 tools such as play, pause, volume and now_playing.

How do I install Hermes Spotify Skill?

Install spotipy and mcp[cli] into the Hermes Python environment, clone the repository, then copy SKILL.md, spotify_mcp.py and auth.py into ~/.hermes/skills/spotify/. After that you create a Spotify Developer app and save its Client ID and Client Secret.

What do I need to run Hermes Spotify Skill?

You need Linux or a Raspberry Pi, a Spotify Premium account and a Spotify Developer app. The redirect URI must be exactly http://127.0.0.1:8888/callback, because Spotify rejects localhost.