MCP Lrclib

mcp-lrclib

LRCLIB is a free, open database of song lyrics, built by the people who use it and offered to anyone without a key or an account. It holds two forms of the words: the plain text of a song, and the LRC form, where every line carries the moment it is sung, which is what a karaoke display or a lyrics panel follows along with. A track is filed there by its title, its artist, its album and its duration, so the several releases of one song sit side by side.

This server connects a chat client to that database. You can search for a track by title, artist or album, read the plain words of a song, read its time-synced lines with their timestamps, and check the metadata of one release before reading it. It needs no API key and no account.

_Version française_

Install

One-click install

Claude Code

claude mcp add lrclib -- npx -y mcp-lrclib

Claude Desktop, Cursor, and any client using the standard config format

{

"mcpServers": { "lrclib": { "command": "npx", "args": ["-y", "mcp-lrclib"] } } }

Node 24 or later is required, and no environment variable has to be set.

With Docker

{

"mcpServers": { "lrclib": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-lrclib:2.1.0"] } } }

-i keeps stdin open, which is where the protocol travels, and -t is left out because a TTY rewrites the stream. The container needs outbound HTTPS to lrclib.net, and nothing else: no volume, no port, no credential.

Bundle, without npm

Download mcp-lrclib-2.1.0.mcpb from the latest release and open it. A client that supports MCP bundles installs it on its own, with no npm and no configuration file to edit. The bundle carries its dependencies, so nothing is fetched at install time.

What you can ask

• "Find me the lyrics of Le Sud by Nino Ferrer."
• "Give me the timed lyrics of Bohemian Rhapsody so I can follow along."
• "Which version of Hallelujah is on LRCLIB, and how long is each one?"
• "Read me the second half of those lyrics."
• "Does track 3396226 have synced lyrics?"

The ordinary path runs from a search to a reading: search_tracks names an id, and get_lyrics takes that id.

Tools

LRCLIB files a track by its metadata, so a search reaches a song through its title, its artist or its album. A word remembered from inside a song finds nothing there.

search_tracks

Finds the tracks whose metadata matches, in one free-text search or in fields of their own. Several releases of one song come back side by side, and their album and duration tell them apart.

Pass query, or one of the three fields.

In return: rows carrying id, which get_lyrics and get_track take; track_name and artist_name; album_name and duration_seconds, which tell two releases of one song apart; instrumental; has_plain_lyrics and has_synced_lyrics, so timed lines can be checked for before they are asked for; and source_url. Alongside come result_count and total_available, the tracks LRCLIB served before limit was applied. album_name and duration_seconds are null on a track filed without them, and the rows carry no words at all: get_lyrics reads those.

get_lyrics

Reads the words of one track, either as plain text or as LRC lines carrying the moment each one is sung. Long lyrics are served a slice at a time, resuming at a line boundary.

In return: status, which reads ok, instrumental for a track with no words to sing, or no_lyrics for one filed without them; track with its id, title, artist, album, duration and source_url; plain_lyrics; synced_lyrics as raw LRC text and synced_lines as a list of { time_seconds, text }, with synced_lines_truncated when the slice cut them. The reading is described by paginated_form, total_chars, returned_chars, offset, next_offset and truncated: pass next_offset back to read on, and null there means the end. attribution is the line to cite when the words are shown. A status of instrumental is a complete answer.

get_track

Reads the metadata of one track from its id, leaving the words aside. It confirms a release before the words are asked for, and it resolves an id carried over from earlier in a conversation.

In return: track, holding the fields a search row carries, and duration_formatted as m:ss, which is null when the track is filed without a duration. has_plain_lyrics and has_synced_lyrics say which forms get_lyrics can serve for it.

Configuration

Every variable is optional. Set them in the env block of your client config.

A value outside its range falls back to the default, and the reason is written to stderr.

Errors

Every failure carries one of six codes, a message, and where it helps a hint naming the next move.

| invalid_input | The arguments were refused before any request went out. | Read the message, which names the argument.