melopulse
Enables importing and recommending Apple Music playlist links in the local catalogue for coding sessions.
Enables importing and recommending Spotify playlist links in the local catalogue for coding sessions.
Enables importing and recommending YouTube Music playlist links in the local catalogue for coding sessions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@melopulserecommend a playlist for a debugging session"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MeloPulse
Local coding playlists for MCP agents.
npx @melolab/melopulse recommendMeloPulse reads safe Git metadata locally, recommends from a local catalogue, and opens playlists in MeloLab or your music app. Recommendation does not upload code or require an account.
What it does
MeloPulse is an offline-first playlist recommender for coding sessions. It includes a small local catalogue, lets you import HTTPS playlist links with local tags, and can explicitly synchronize MeloLab's public catalogue into a local cache. It returns playlist URLs; your browser or music app handles playback.
It does not generate music, store audio, authenticate users, use OAuth, control a player, monitor repositories in the background, send telemetry, or fetch provider metadata. The only network operation is an explicit sync request to MeloLab.
Related MCP server: Last.fm Taste MCP
Install and use
The package is not published until a separate release action occurs. Until then, run from a local checkout with npm run build and node dist/cli/index.js <command>.
Once published, use the CLI with npx:
npx -y @melolab/melopulse recommend --activity debugging
npx -y @melolab/melopulse recommend --no-git --jsonCLI commands
Command | Purpose |
| Import an HTTPS playlist link into the local catalogue. Use |
| Explicitly download MeloLab's public featured catalogue and update the local cache. |
| Return up to three local recommendations. Git context is enabled by default; use |
| Hand a selected playlist URL to the operating system's default browser or registered music app. |
| Start the MCP server over standard input/output. |
recommend accepts --activity, --mood, --energy, --focus, --vocals, --limit, and --json. Recommendation uses the bundled catalogue, your local link imports, and any cached MeloLab sync; it does not query streaming providers.
MCP tools
The MCP server exposes exactly four tools:
Tool | Purpose |
| Recommend from the local catalogue, optionally using safe Git context. |
| Import and tag an HTTPS playlist link locally. |
| List local catalogue entries, optionally filtered by source. |
| Explicitly synchronize MeloLab's public catalogue. |
See MCP setup and copy the ready-made configurations in examples.
Supported playlist links
MeloPulse accepts HTTPS links and recognizes MeloLab, Spotify, Apple Music, and YouTube Music links. Other HTTPS playlist links are stored as generic. Link import only saves the URL and your local tags; it does not retrieve provider metadata or audio.
Local storage and privacy
The local catalogue is stored in the platform configuration directory, or in MELOPULSE_CONFIG_DIR when set. It contains playlists.json for local imports and melolab-catalog-cache.json for the last explicit MeloLab sync.
When Git context is enabled, MeloPulse reads only safe metadata from the chosen workspace. It never uploads repository contents, source code, file contents, remote URLs, credentials, or audio. Read the complete privacy boundary.
MeloLab relationship
MeloPulse is a local recommender that can hand off a MeloLab playlist URL to your browser or app. MeloLab sync is opt-in and happens only when you run melopulse sync or call melopulse_sync_catalog; there is no background synchronization, account connection, OAuth, or provider integration.
Development
npm ci
npm run verify
npm run smoke:pack
npm pack --dry-runThe packed-install smoke test builds an npm tarball, installs it in a temporary directory, runs recommend --no-git --json, verifies a recommendation is returned, and cleans up both locations.
Contributing and security
Please read CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md before participating.
License
MIT © 2026 Tover0314
This server cannot be deployed
Maintenance
Related MCP Connectors
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
The media memory layer for AI agents and their humans. Your AI client gets 29 tools to search your collection, add items, update ratings, preview music, and find patterns across everything you've read, watched, and listened to.
Melaya is a remote MCP server. It gives an assistant hands on your own Android phone and browser: it reads the screen through the accessibility tree, then taps, types and navigates inside the apps and sites you allow-list, with no per-app API. It also builds, schedules and runs agent pipelines across 6k+ connected tools. OAuth 2.1, nothing to install.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server for Spotify control and synchronized lyrics retrieval that enables playback management, queue navigation, and music search capabilities. It also features perception tools for real-time track analysis, including BPM, key detection, and timestamped lyrics.95 npm3Apache 2.0
- AlicenseNot gradedqualityBmaintenanceProvides Last.fm listening analytics and recommendations by combining Last.fm and MusicBrainz metadata, maintaining a local listening index, and recording explicit preferences. Enables queries for listening summaries, taste profiles, artist context, and evidence-backed recommendations via MCP tools.MIT
- AlicenseBqualityBmaintenanceA local-first Spotify MCP server providing typed tools for music search, playback, playlists, audio analysis, and snapshot-safe DJ planning, with OAuth PKCE and no client secret stored.531MIT
- AlicenseNot gradedqualityAmaintenanceA local MCP server for managing and organizing a personal QQ Music library, enabling playlist operations, music analysis, and intelligent classification workflows with safe write-back and rollback.2MIT