How do I connect Navidrome MCP Server to Claude?

Run `claude mcp add navidrome-mcp -- npx -y navidrome-config` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Navidrome MCP Server free?

The listed licence is AGPL-3.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Navidrome MCP Server do?

Navidrome MCP Server documents 40 tools to the agent, including add_tracks_to_playlist, clear_saved_queue, create_playlist. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Navidrome MCP

Unclaimed

by Blakeem

Analyze listening patterns, build playlists, find missing albums, discover similar artists via Last.fm, fetch synced lyrics, and explore global radio. Play it all through your speakers via mpv, with a built-in web UI that makes any device with a brower act as a remote. Gives full control of your Navidrome library using natural language.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'navidrome-mcp' -- 'npx' '-y' 'navidrome-config'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

mcpmcp-servernavidrome

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

40 of 40 tools

Documented tools (40)

From project documentation. A server handshake does not verify each tool’s description or behavior.

add_tracks_to_playlist

Add songs, albums, artist discographies, or specific discs in one operation

clear_saved_queue

Clear the Navidrome saved queue

create_playlist

Create a new playlist

delete_playlist

Delete a playlist

get_album

Detailed album metadata by ID

get_album_info

Album detail: tracklist with durations, year and type, genres, wiki summary, popularity, and library membership. Works for albums you don't own

get_artist

Detailed artist metadata by ID

get_artist_albums

Full discography with release types and years (MusicBrainz), genres and popularity (Last.fm), and an in-library flag per album. Answers "what albums by X am I missing?"

get_artist_info

Artist biography and tags

get_filter_options

Discover available filter values for search operations

get_playlist

Get playlist metadata by ID

get_playlist_tracks

Get playlist contents (JSON or M3U)

get_saved_queue

Read the Navidrome saved queue (web UI sync)

get_similar_artists

Find artists similar to a given artist

get_similar_tracks

Find tracks similar to a given track

get_song

Detailed song metadata by ID

get_song_playlists

List all playlists containing a given song

get_tag_distribution

Tag usage counts across the library

get_top_tracks_by_artist

Top tracks for an artist

get_trending_music

Trending artists, tracks, and tags from Last.fm charts

get_user_details

User profile, available libraries, and active-library status

list_most_played

Most-played songs, albums, or artists

list_playlists

View all accessible playlists

list_recently_played

Recent listening activity with optional time-range filter

list_starred_items

View starred songs, albums, or artists

list_top_rated

View highest-rated items

remove_tracks_from_playlist

Remove tracks by position

reorder_playlist_track

Move a track to a new position

save_queue

Save a queue to Navidrome for web UI sync

search_albums

Search albums with advanced filters and sorting

search_all

Search across artists, albums, and songs with filters and sorting

search_artists

Search artists with advanced filters and sorting

search_by_tags

Search by tag values (genre, releasetype, media, etc.)

search_songs

Search songs with advanced filters and sorting

set_active_libraries

Set which libraries are active for all search/list operations

set_rating

Set a 0-5 star rating

star_item

Star a song, album, or artist

test_connection

Verify Navidrome connectivity and report feature/tool availability

unstar_item

Remove a star

update_playlist

Update name, description, or visibility

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Navidrome MCP Server

How do I connect Navidrome MCP Server to Claude?: Run `claude mcp add navidrome-mcp -- npx -y navidrome-config` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Navidrome MCP Server free?: The listed licence is AGPL-3.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Navidrome MCP Server do?: Navidrome MCP Server documents 40 tools to the agent, including add_tracks_to_playlist, clear_saved_queue, create_playlist. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.