spotify-mood

Spotify Mood Plugin for Claude Code

AI-powered Spotify playlist generator that reads your health data, neurochemical optimization preferences, and work tempo to create the perfect playlist for right now.

Installation

# Add the plugin
claude plugin add https://github.com/fredzannarbor/spotify-mood-plugin

# Run setup
/spotify-mood-setup

Requirements

• Spotify Developer Account (free): developer.spotify.com
• Python 3.10+ with spotipy package
• Optional: SQLite health database with health_metrics and daily_logs tables

Commands

Command	Description
/spotify-mood	Generate a playlist tuned to your current state
/spotify-playlist	Create a playlist from free-text description
/feed-prefs	Customize neurochemical optimization weights
/work-tempo	Assess your current work context
/spotify-mood-setup	First-time configuration
/showmethescience	Research rationale behind the approach

How It Works

/spotify-mood integrates three signals to pick the right music:

1. Health & Mood (Optional)

If you connect a health database, the plugin reads:

• Sleep — Low sleep triggers Recovery mode
• Mood & Energy — Subjective 1-10 ratings
• HRV — Heart rate variability as stress indicator
• Caffeine — Stimulant load
• Exercise — Recent physical activity

2. Neurochemical Weights

Four dimensions control the character of your playlist:

Dimension	Neurochemical	Music Character
Learning	Acetylcholine	Instrumental, ambient, focus
Engagement	Dopamine	Familiar hits, rhythmic
Breakthrough	Norepinephrine	Eclectic, genre-crossing
Mood	Serotonin	Uplifting, warm, feel-good

Adjust with /feed-prefs or use presets: balanced, scholar, social, creative, uplifting.

3. Work Tempo

Automatic detection based on:

• Time of day — Morning focus vs. evening wind-down
• Day of week — Workday vs. weekend
• Manual override — "deadline crunch", "winding down", etc.

Music Profiles

The three signals combine into one of eight music profiles:

Profile	When	BPM	Energy
Recovery	Low sleep, low mood	60-90	Low
Gentle Focus	Low sleep, OK mood	70-100	Low-Med
Power Mode	Good sleep, high energy	110-140	High
Activation	Good sleep, low energy	90-120	Med-High
Calm Down	High stress	50-80	Low
Channel It	High caffeine + energy	120-150	High
Wind Down	Evening	50-85	Low
Groove	Weekend + good mood	100-130	Medium

Health Database Schema

If you want to connect health data, your SQLite database needs these tables:

CREATE TABLE health_metrics (
    id TEXT PRIMARY KEY,
    date TEXT NOT NULL,
    metric_type TEXT NOT NULL,  -- sleep_hours, hrv, caffeine, exercise_mins, steps, daylight_mins
    value REAL NOT NULL,
    unit TEXT,
    notes TEXT
);

CREATE TABLE daily_logs (
    id TEXT PRIMARY KEY,
    date TEXT NOT NULL,
    time TEXT,
    mood_score INTEGER,      -- 1-10
    energy_level INTEGER,    -- 1-10
    notes TEXT
);

Compatible with Apple Health exports, Fitbit data, or manual logging.

Data Storage

~/.spotify-mood/
├── config.json          # Spotify creds + health DB path
├── preferences.json     # Neurochemical weights
├── .spotify_cache       # OAuth token (auto-managed)
└── playlist_history.json # Log of created playlists

Privacy

• All data stays local — no cloud services beyond Spotify's API
• Health data is read-only — the plugin never writes to your health database
• Playlist history is stored locally for your reference
• No analytics or telemetry

License

MIT

Credits

Built by Nimble Books LLC for the Claude Code plugin ecosystem.

Neurochemical optimization framework adapted from the Agentic Social Feed project.