@freeyourmusic/mcp
v9.27.0
Published
MCP (Model Context Protocol) server that exposes Free Your Music to AI agents. Stdio transport — runs as a subprocess managed by an MCP host.
Readme
@freeyourmusic/mcp
MCP (Model Context Protocol) server that exposes Free Your Music to AI agents. Stdio transport — runs as a subprocess managed by an MCP host (Claude Desktop, Cursor, Cline, Claude Code, etc.).
Requires Free Your Music desktop running. See
@freeyourmusic/clifor the wire format.
Install for an MCP host
# Claude Desktop
npx -y @freeyourmusic/mcp install --host=claude-desktop
# Claude Code
npx -y @freeyourmusic/mcp install --host=claude-code
# Cursor
npx -y @freeyourmusic/mcp install --host=cursor
# Cline
npx -y @freeyourmusic/mcp install --host=cline
# Print the JSON snippet (manual install)
npx -y @freeyourmusic/mcp install --host=printThen restart the host. The tools appear under the freeyourmusic server.
Tool catalog (v1)
Read (free): fym_status, fym_services, fym_login, fym_playlists_list, fym_playlists_get,
fym_tracks_list, fym_library_tracks, fym_library_albums, fym_library_artists, fym_history_recent
Search (free with 100/day quota): fym_search_tracks, fym_search_albums, fym_search_artists
Write (Pro): fym_playlists_create, fym_playlists_rename, fym_playlists_delete,
fym_tracks_add, fym_tracks_remove, fym_tracks_reorder, fym_library_like,
fym_follow_artist, fym_unfollow_artist
Privacy
No telemetry added. All traffic to the bridge is 127.0.0.1. The bearer token rotates on every desktop launch.
