Integration

Lidarr integration

Lidarr is a self-hosted music collection manager. The v1 REST API drives the same operations as its web UI: look artists and albums up on MusicBrainz and add them with a quality profile, a metadata profile and a root folder, monitor or unmonitor albums individually or through album studio, list tracks and track files, browse the calendar and the wanted lists of missing or below-cutoff albums, search indexers and push or grab a specific release, inspect and remove items from the download queue, read grab and import history, manage the blocklist, quality and metadata profiles, custom formats, root folders, tags, import lists, list exclusions, indexers and download clients, run manual imports and previews of file renames and retags, queue background commands such as RefreshArtist or AlbumSearch, and read health checks, disk space, scheduled tasks and system status. Point the credential at your own Lidarr host and authenticate with the API key from Settings > General.

Connect Lidarr How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Lidarr.Built from the 136 Lidarr tools below, on the connection you add once.

What you can do with Lidarr

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Album, 9 operations

create_albumCreate albumPOSTAdds an album to the library from a lookup result.
delete_albumDelete albumDELETERemoves one album, optionally deleting its files.
get_albumGet albumGETReturns one album with its releases, tracks and monitoring state.
get_album_media_coverGet album media coverGETget album.
list_albumsList albumsGETLists albums for an artist, for a set of album ids, or for a foreign MusicBrainz id.
lookup_albumLookup albumGETSearches MusicBrainz by free text and returns the albums that could be added.
set_albums_monitoredSet albums monitoredPUTMonitors or unmonitors a set of albums given by id.
update_albumUpdate albumPUTUpdates one album, for example its monitoring or the release chosen for it.
update_album_studioUpdate album studioPOSTSets which albums of which artists are monitored, in one call.

Artist, 9 operations

create_artistCreate artistPOSTAdds an artist to the library from a lookup result, with its quality profile, metadata profile, root folder and monitoring choice.
delete_artistDelete artistDELETERemoves an artist from the library, optionally deleting its files and adding an import list exclusion.
delete_artists_bulkDelete artists bulkDELETEDeletes several artists at once, optionally with their files.
get_artistGet artistGETReturns one artist with its statistics and paths.
get_artist_media_coverGet artist media coverGETget artist.
list_artistsList artistsGETLists the artists in the library, or the single artist matching a MusicBrainz id.
lookup_artistLookup artistGETSearches MusicBrainz by free text and returns the artists that could be added.
update_artistUpdate artistPUTUpdates one artist, for example its monitoring, profiles, tags or path.
update_artists_bulkUpdate artists bulkPUTApplies one change, such as a profile, root folder or monitoring state, to several artists at once.

Queue, 7 operations

delete_queueDelete queueDELETERemoves one item from the queue, optionally telling the download client to remove it and blocklisting its release.
delete_queue_bulkDelete queue bulkDELETERemoves several queue items in one call.
get_queue_statusGet queue statusGETReturns queue counters: total, errors, warnings and items waiting for manual intervention.
grab_queue_itemGrab queue itemPOSTForces Lidarr to import a queued item that is waiting rather than importing on its own.
grab_queue_itemsGrab queue itemsPOSTForces the import of several waiting queue items in one call.
list_queueList queueGETReturns a page of the download queue with per-item progress, size, status and estimated completion.
list_queue_detailsList queue detailsGETReturns queue entries expanded with the library records they belong to.

Tag, 6 operations

create_tagCreate tagPOSTAdds a tag to Lidarr.
delete_tagDelete tagDELETEDeletes the tag with the given id.
get_tagGet tagGETReturns the tag with the given id.
get_tag_detailGet tag detailGETReturns one tag with the records, profiles and connections it is attached to.
list_tag_detailsList tag detailsGETLists tags together with the records, profiles and connections each one is attached to.
list_tagsList tagsGETLists the tags defined in Lidarr. Each is a label that can be attached to records, profiles, indexers and connections.

Custom filter, 5 operations

create_custom_filterCreate custom filterPOSTAdds a custom filter to Lidarr.
delete_custom_filterDelete custom filterDELETEDeletes the custom filter with the given id.
get_custom_filterGet custom filterGETReturns the custom filter with the given id.
list_custom_filtersList custom filtersGETLists the custom filters defined in Lidarr. Each is a saved filter definition the app's own list views use.
update_custom_filterUpdate custom filterPUTUpdates the custom filter with the given id.

Download client, 5 operations

create_download_clientCreate download clientPOSTAdds a download client to Lidarr.
delete_download_clientDelete download clientDELETEDeletes the download client with the given id.
delete_download_client_bulkDelete download client bulkDELETEDeletes several download clients in one call.
get_download_clientGet download clientGETReturns the download client with the given id.
list_download_clientsList download clientsGETLists the download clients defined in Lidarr. Each is a connection to a Usenet or torrent client that grabs are handed to.

Import list, 5 operations

create_import_listCreate import listPOSTAdds an import list to Lidarr.
delete_import_listDelete import listDELETEDeletes the import list with the given id.
delete_import_list_bulkDelete import list bulkDELETEDeletes several import lists in one call.
get_import_listGet import listGETReturns the import list with the given id.
list_import_listsList import listsGETLists the import lists defined in Lidarr. Each is a source that adds records to the library automatically.

Indexer, 5 operations

create_indexerCreate indexerPOSTAdds an indexer to Lidarr.
delete_indexerDelete indexerDELETEDeletes the indexer with the given id.
delete_indexer_bulkDelete indexer bulkDELETEDeletes several indexers in one call.
get_indexerGet indexerGETReturns the indexer with the given id.
list_indexersList indexersGETLists the indexers defined in Lidarr. Each is a Usenet or torrent indexer that is searched for releases.

Command, 4 operations

cancel_commandCancel commandDELETECancels a queued or running background command.
get_command_statusGet command statusGETReturns the state, progress and result of one background command.
list_commandsList commandsGETLists the background commands queued, running or recently finished, with their progress.
run_commandRun commandPOSTQueues a background command by name, for example RefreshArtist, RescanFolders or AlbumSearch. Any other body field is passed to the command as one of its parameters.

Custom format, 4 operations

create_custom_formatCreate custom formatPOSTAdds a custom format to Lidarr.
delete_custom_formatDelete custom formatDELETEDeletes the custom format with the given id.
get_custom_formatGet custom formatGETReturns the custom format with the given id.
list_custom_formatsList custom formatsGETLists the custom formats defined in Lidarr. Each is a scoring rule matched against release names and media info.

History, 4 operations

list_artist_historyList artist historyGETReturns history events for one artist, optionally narrowed to an album.
list_historyList historyGETReturns a page of grab, import, upgrade, rename and failure events, newest first.
list_history_sinceList history sinceGETReturns every history event recorded since a date, with no paging.
mark_history_item_failedMark history item failedPOSTMarks a history item as failed, which blocklists its release and lets a fresh search run.

Import list exclusion, 4 operations

create_import_list_exclusionCreate import list exclusionPOSTAdds an import list exclusion to Lidarr.
delete_import_list_exclusionDelete import list exclusionDELETEDeletes the import list exclusion with the given id.
get_import_list_exclusionGet import list exclusionGETReturns the import list exclusion with the given id.
list_import_list_exclusionsList import list exclusionsGETLists the import list exclusions defined in Lidarr. Each names a record that import lists must never add back.

Metadata profile, 4 operations

create_metadata_profileCreate metadata profilePOSTAdds a metadata profile to Lidarr.
delete_metadata_profileDelete metadata profileDELETEDeletes the metadata profile with the given id.
get_metadata_profileGet metadata profileGETReturns the metadata profile with the given id.
list_metadata_profilesList metadata profilesGETLists the metadata profiles defined in Lidarr. Each decides which release types and secondary types are fetched.

Notification, 4 operations

create_notificationCreate notificationPOSTAdds a notification connection to Lidarr.
delete_notificationDelete notificationDELETEDeletes the notification connection with the given id.
get_notificationGet notificationGETReturns the notification connection with the given id.
list_notificationsList notificationsGETLists the notification connections defined in Lidarr. Each is a connect target such as Discord, Telegram, a webhook or a media server.

Quality profile, 4 operations

create_quality_profileCreate quality profilePOSTAdds a quality profile to Lidarr.
delete_quality_profileDelete quality profileDELETEDeletes the quality profile with the given id.
get_quality_profileGet quality profileGETReturns the quality profile with the given id.
list_quality_profilesList quality profilesGETLists the quality profiles defined in Lidarr. Each holds an ordered list of qualities and the cutoff at which upgrading stops.

Root folder, 4 operations

create_root_folderCreate root folderPOSTAdds a root folder to Lidarr.
delete_root_folderDelete root folderDELETEDeletes the root folder with the given id.
get_root_folderGet root folderGETReturns the root folder with the given id.
list_root_foldersList root foldersGETLists the root folders defined in Lidarr. Each is a library path that new records are stored under.

Track file, 4 operations

delete_track_fileDelete track fileDELETEDeletes one track file from disk.
delete_track_file_bulkDelete track file bulkDELETEDeletes several track files from disk in one call.
get_track_fileGet track fileGETReturns one track file with its quality, size and media info.
list_track_filesList track filesGETLists the track files of an artist or album, or the files given by id, with quality and media info.

Blocklist, 3 operations

delete_blocklistDelete blocklistDELETERemoves one release from the blocklist so it can be grabbed again.
delete_blocklist_bulkDelete blocklist bulkDELETERemoves several releases from the blocklist in one call.
list_blocklistList blocklistGETReturns a page of blocklisted releases, the ones Lidarr refuses to grab again after a failed download.

Release, 3 operations

grab_releaseGrab releasePOSTSends one release from a search result to a download client.
push_releasePush releasePOSTPushes a release Lidarr did not find itself, so it is handled as though an indexer had returned it.
search_releasesSearch releasesGETRuns an indexer search and returns the releases found, each with quality, size, seeders, age and the reasons Lidarr would reject it.

Calendar, 2 operations

get_calendar_albumGet calendar albumGETReturns one calendar entry by id.
list_calendar_albumsList calendar albumsGETLists the albums scheduled between two dates, as the calendar view shows them.

Cutoff unmet, 2 operations

get_cutoff_unmet_albumGet cutoff unmet albumGETReturns one below-cutoff album by id.
list_cutoff_unmet_albumsList cutoff unmet albumsGETReturns a page of monitored albums whose existing file is below the profile cutoff.

Language, 2 operations

get_languageGet languageGETReturns one language by id.
list_languagesList languagesGETLists the languages Lidarr can recognise in a release.

Missing, 2 operations

get_missing_albumGet missing albumGETReturns one monitored album that has no file, by id.
list_missing_albumsList missing albumsGETReturns a page of monitored albums that have no file yet.

Quality definition, 2 operations

get_quality_definitionGet quality definitionGETReturns the quality definition with the given id.
list_quality_definitionsList quality definitionsGETLists the quality definitions defined in Lidarr. Each holds the minimum and maximum size accepted for one quality.

Scheduled task, 2 operations

get_scheduled_taskGet scheduled taskGETReturns one scheduled task by id.
list_scheduled_tasksList scheduled tasksGETLists the scheduled tasks with their interval and their last and next run times.

Track, 2 operations

get_trackGet trackGETReturns one track with its duration, number and file.
list_tracksList tracksGETLists tracks for an artist, an album or an album release.

Backup, 1 operation

list_backupsList backupsGETLists the database backups on disk.

Disk space, 1 operation

list_disk_spaceList disk spaceGETReports free and total space for every disk that holds a root folder.

Health check, 1 operation

list_health_checksList health checksGETLists the health checks currently failing, each with its source, type and message.

Indexer flag, 1 operation

list_indexer_flagsList indexer flagsGETLists the flags a release can carry, such as freeleech or internal.

Log file, 1 operation

list_log_filesList log filesGETLists the log files on disk with their size and last write time.

Log record, 1 operation

list_log_recordsList log recordsGETReturns a page of log records, filterable by level.

Manual import, 1 operation

list_manual_import_candidatesList manual import candidatesGETLists the files found under a folder together with the album, quality and language Lidarr parsed from each, so an import can be reviewed before it runs.

Parse, 1 operation

parse_release_titleParse release titleGETParses a release title and returns what Lidarr recognised in it, including the matching library record.

Rename, 1 operation

preview_track_renamesPreview track renamesGETLists the track files whose names differ from the configured naming scheme, with the name each would be given.

Retag, 1 operation

preview_track_retagsPreview track retagsGETLists the track files whose embedded tags differ from the metadata Lidarr holds, with the changes each would receive.

Search, 1 operation

search_artists_and_albumsSearch artists and albumsGETSearches MusicBrainz for artists and albums in one call and returns both kinds of result.

System status, 1 operation

get_system_statusGet system statusGETReturns version, build date, runtime, operating system, configured paths and authentication mode.

Update, 1 operation

list_available_updatesList available updatesGETLists the Lidarr versions available to update to, newest first, with their changes.

Showing the first 120 of 136 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Lidarr from Claude Code, Cursor or Codex

Connect Lidarr in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Lidarr operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Lidarr

Create your workspace
Sign up free. Nothing to install.
Connect Lidarr once
Add your Lidarr connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.