# hum

> hum is a free MCP server for events and entertainment. Play songs, mood stations and Spotify links in your browser from a coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, self-hosted, CLI
- **Website:** https://hum.anzalabidi.dev
- **Repository:** https://github.com/anzal1/hum
- **MCP Registry name:** io.github.anzal1/hum
- **Categories:** events and entertainment
- **Listing updated:** 2026-11-16

## About

hum is a small local music player that an agent can start while you code. You search for a song or paste a Spotify playlist, album or track link, and playback happens in your browser through YouTube's official embedded player, so ads and royalties work the normal way. Tapping a station plays that mood continuously, with time-synced lyrics, an endless autoplay mix, liked songs and shareable song links.

There are no accounts or keys. Your library sits in browser storage, and optional sync uses a generated code: the library is encrypted in the browser with AES-256-GCM, so the server only sees an id and ciphertext. Anyone holding the code can read and change the library, and lost codes cannot be recovered.

It installs as an MCPB bundle over stdio and uses port 3737 by default, configurable with HUM_PORT. The README also covers running it with npx, from a clone, in Docker, or deploying to Cloudflare Workers' free tier.

## Features

- **Search and Spotify links:** Find songs or paste a Spotify playlist, album or track.
- **Mood stations:** Stations play on in a chosen mood.
- **Synced lyrics:** Shows time-synced lyrics while playing.
- **Account-free library:** Likes and playlists stay in your browser.
- **Encrypted sync:** A generated code syncs the library across devices.
- **Flexible hosting:** Run locally, in Docker or on Cloudflare Workers.

## Good for

- Play background music while an agent writes code
- Turn a Spotify playlist into something that plays in the browser
- Keep a liked-songs library without signing up
- Host a personal player on a home server

## Install

### Claude Code (Terminal)

```sh
claude mcp add hum -- npx -y https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hum": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hum": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hum": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hum": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hum": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it need an account?

No accounts or keys are required.

### How is audio played?

Through YouTube's official embedded player.

### How do I change the port?

Set HUM_PORT; the default is 3737.

### Is sync private?

The library is encrypted in the browser, but anyone with the sync code can read and change it.

### Is hum free?

Yes. hum is free to use.

### How do I add hum to Claude Code?

Run this command in your terminal: claude mcp add hum -- npx -y https://github.com/anzal1/hum/releases/download/v0.2.1/hum.mcpb

### What are the best alternatives to hum?

The closest alternatives to hum are MaineMCP, Agent Bookability Index, Tap2Cal, Veseljko katalog usluga za proslave and 숏츠생성기 Free K-pop Shorts.

## Alternatives

- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.
- [숏츠생성기 Free K-pop Shorts](https://ai-powered.com/mcp/free-k-pop-shorts): 숏츠생성기 Free K-pop Shorts is a free MCP server for design and media.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Last.fm MCP](https://ai-powered.com/mcp/last-fm-mcp): Last.fm MCP is an open-source MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/hum
