Navidrome-MCP

Overview

Navidrome-MCP transforms your Navidrome music server into a conversational music assistant. It allows browsing and searching your library, building playlists, discovering new music through Last.fm, fetching synced lyrics, and streaming audio directly through your speakers using mpv. The server includes a built-in web UI that lets any device with a browser act as a remote control. It integrates fully with Navidrome, maintaining play counts and recently-played data synchronization across devices and platforms.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• browse_songs

  Browse and search songs with rich filtering options

  Try:Show me all my starred jazz albums from the 90sTry:Find songs tagged Soundtrack with 5-star rating
• play_audio

  Play songs through local speakers using mpv

  Try:Play 5 random starred albumsTry:Queue everything I've starred from the 90s sorted by year
• create_playlist

  Create and manage playlists with various content options

  Try:Create a playlist of my top 10 rock songsTry:Build a 'Hidden Gems' playlist of 5-star songs with under 5 plays
• discover_music

  Find similar artists and tracks via Last.fm

  Try:Find similar artists to my favorite bandTry:Discover tracks similar to songs I love but never play
• fetch_lyrics

  Fetch time-synced lyrics from LRCLIB database

  Try:Get lyrics for 'Bohemian Rhapsody'Try:Show synchronized lyrics for the current song
• manage_radio

  Manage Navidrome radio stations and discover new ones

  Try:Add this radio station: http://example.com/streamTry:Find popular jazz stations from France
• listening_analytics

  Access play counts, recently-played activity, and top-rated listings

  Try:Show my most played songs this monthTry:What genres am I playing more this year vs last year
• manage_ratings

  Star/unstar items and set 0-5 star ratings

  Try:Give this album 5 starsTry:Show me all my starred albums
• manage_library

  Switch between different Navidrome libraries

  Try:Switch to my classical music libraryTry:Show me only library 2 content

Comparable tools

Installation

npm install -g navidrome-mcp

{
  "mcpServers": {
    "navidrome": {
      "command": "npx",
      "args": ["navidrome-mcp"],
      "env": {
        "NAVIDROME_URL": "http://your-server:4533",
        "NAVIDROME_USERNAME": "your_username",
        "NAVIDROME_PASSWORD": "your_password",
        "LASTFM_API_KEY": "your_api_key",
        "RADIO_BROWSER_USER_AGENT": "Navidrome-MCP/2.0 (+https://github.com/Blakeem/Navidrome-MCP)",
        "LYRICS_PROVIDER": "lrclib",
        "LRCLIB_USER_AGENT": "Navidrome-MCP/2.0 (+https://github.com/Blakeem/Navidrome-MCP)"
      }
    }
  }
}

FAQ

Can I control playback without installing mpv?

Yes, you can still browse and manage your library, build playlists, and control Navidrome's queue without mpv. mpv is only required for local audio playback through your speakers.

Which MCP clients are compatible with Navidrome-MCP?

It's compatible with Claude Desktop, Claude Code, Cursor, and any other MCP client with local stdio support. Note: ChatGPT Desktop currently requires a hosted HTTPS endpoint, so it's not directly compatible.

Compare Navidrome-MCP with