What can you do with the Lidarr integration?

LiveContext exposes 136 operations on Lidarr, covering album, artist, queue and tag.

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.

136 toolsAPI keyAPI docs

Connect Lidarr How integrations work

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

POSTcreate_album
Adds an album to the library from a lookup result.
DELETEdelete_album
Removes one album, optionally deleting its files.
GETget_album
Returns one album with its releases, tracks and monitoring state.
GETget_album_media_cover
get album.
GETlist_albums
Lists albums for an artist, for a set of album ids, or for a foreign MusicBrainz id.
GETlookup_album
Searches MusicBrainz by free text and returns the albums that could be added.
PUTset_albums_monitored
Monitors or unmonitors a set of albums given by id.
PUTupdate_album
Updates one album, for example its monitoring or the release chosen for it.
POSTupdate_album_studio
Sets which albums of which artists are monitored, in one call.

Artist, 9 operations

POSTcreate_artist
Adds an artist to the library from a lookup result, with its quality profile, metadata profile, root folder and monitoring choice.
DELETEdelete_artist
Removes an artist from the library, optionally deleting its files and adding an import list exclusion.
DELETEdelete_artists_bulk
Deletes several artists at once, optionally with their files.
GETget_artist
Returns one artist with its statistics and paths.
GETget_artist_media_cover
get artist.
GETlist_artists
Lists the artists in the library, or the single artist matching a MusicBrainz id.
GETlookup_artist
Searches MusicBrainz by free text and returns the artists that could be added.
PUTupdate_artist
Updates one artist, for example its monitoring, profiles, tags or path.
PUTupdate_artists_bulk
Applies one change, such as a profile, root folder or monitoring state, to several artists at once.

Queue, 7 operations

DELETEdelete_queue
Removes one item from the queue, optionally telling the download client to remove it and blocklisting its release.
DELETEdelete_queue_bulk
Removes several queue items in one call.
GETget_queue_status
Returns queue counters: total, errors, warnings and items waiting for manual intervention.
POSTgrab_queue_item
Forces Lidarr to import a queued item that is waiting rather than importing on its own.
POSTgrab_queue_items
Forces the import of several waiting queue items in one call.
GETlist_queue
Returns a page of the download queue with per-item progress, size, status and estimated completion.
GETlist_queue_details
Returns queue entries expanded with the library records they belong to.

Tag, 6 operations

POSTcreate_tag
Adds a tag to Lidarr.
DELETEdelete_tag
Deletes the tag with the given id.
GETget_tag
Returns the tag with the given id.
GETget_tag_detail
Returns one tag with the records, profiles and connections it is attached to.
GETlist_tag_details
Lists tags together with the records, profiles and connections each one is attached to.
GETlist_tags
Lists the tags defined in Lidarr. Each is a label that can be attached to records, profiles, indexers and connections.

Custom filter, 5 operations

POSTcreate_custom_filter
Adds a custom filter to Lidarr.
DELETEdelete_custom_filter
Deletes the custom filter with the given id.
GETget_custom_filter
Returns the custom filter with the given id.
GETlist_custom_filters
Lists the custom filters defined in Lidarr. Each is a saved filter definition the app's own list views use.
PUTupdate_custom_filter
Updates the custom filter with the given id.

Download client, 5 operations

POSTcreate_download_client
Adds a download client to Lidarr.
DELETEdelete_download_client
Deletes the download client with the given id.
DELETEdelete_download_client_bulk
Deletes several download clients in one call.
GETget_download_client
Returns the download client with the given id.
GETlist_download_clients
Lists 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

POSTcreate_import_list
Adds an import list to Lidarr.
DELETEdelete_import_list
Deletes the import list with the given id.
DELETEdelete_import_list_bulk
Deletes several import lists in one call.
GETget_import_list
Returns the import list with the given id.
GETlist_import_lists
Lists the import lists defined in Lidarr. Each is a source that adds records to the library automatically.

Indexer, 5 operations

POSTcreate_indexer
Adds an indexer to Lidarr.
DELETEdelete_indexer
Deletes the indexer with the given id.
DELETEdelete_indexer_bulk
Deletes several indexers in one call.
GETget_indexer
Returns the indexer with the given id.
GETlist_indexers
Lists the indexers defined in Lidarr. Each is a Usenet or torrent indexer that is searched for releases.

Command, 4 operations

DELETEcancel_command
Cancels a queued or running background command.
GETget_command_status
Returns the state, progress and result of one background command.
GETlist_commands
Lists the background commands queued, running or recently finished, with their progress.
POSTrun_command
Queues 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

POSTcreate_custom_format
Adds a custom format to Lidarr.
DELETEdelete_custom_format
Deletes the custom format with the given id.
GETget_custom_format
Returns the custom format with the given id.
GETlist_custom_formats
Lists the custom formats defined in Lidarr. Each is a scoring rule matched against release names and media info.

History, 4 operations

GETlist_artist_history
Returns history events for one artist, optionally narrowed to an album.
GETlist_history
Returns a page of grab, import, upgrade, rename and failure events, newest first.
GETlist_history_since
Returns every history event recorded since a date, with no paging.
POSTmark_history_item_failed
Marks a history item as failed, which blocklists its release and lets a fresh search run.

Import list exclusion, 4 operations

POSTcreate_import_list_exclusion
Adds an import list exclusion to Lidarr.
DELETEdelete_import_list_exclusion
Deletes the import list exclusion with the given id.
GETget_import_list_exclusion
Returns the import list exclusion with the given id.
GETlist_import_list_exclusions
Lists the import list exclusions defined in Lidarr. Each names a record that import lists must never add back.

Metadata profile, 4 operations

POSTcreate_metadata_profile
Adds a metadata profile to Lidarr.
DELETEdelete_metadata_profile
Deletes the metadata profile with the given id.
GETget_metadata_profile
Returns the metadata profile with the given id.
GETlist_metadata_profiles
Lists the metadata profiles defined in Lidarr. Each decides which release types and secondary types are fetched.

Notification, 4 operations

POSTcreate_notification
Adds a notification connection to Lidarr.
DELETEdelete_notification
Deletes the notification connection with the given id.
GETget_notification
Returns the notification connection with the given id.
GETlist_notifications
Lists 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

POSTcreate_quality_profile
Adds a quality profile to Lidarr.
DELETEdelete_quality_profile
Deletes the quality profile with the given id.
GETget_quality_profile
Returns the quality profile with the given id.
GETlist_quality_profiles
Lists the quality profiles defined in Lidarr. Each holds an ordered list of qualities and the cutoff at which upgrading stops.

Root folder, 4 operations

POSTcreate_root_folder
Adds a root folder to Lidarr.
DELETEdelete_root_folder
Deletes the root folder with the given id.
GETget_root_folder
Returns the root folder with the given id.
GETlist_root_folders
Lists the root folders defined in Lidarr. Each is a library path that new records are stored under.

Track file, 4 operations

DELETEdelete_track_file
Deletes one track file from disk.
DELETEdelete_track_file_bulk
Deletes several track files from disk in one call.
GETget_track_file
Returns one track file with its quality, size and media info.
GETlist_track_files
Lists the track files of an artist or album, or the files given by id, with quality and media info.

Blocklist, 3 operations

DELETEdelete_blocklist
Removes one release from the blocklist so it can be grabbed again.
DELETEdelete_blocklist_bulk
Removes several releases from the blocklist in one call.
GETlist_blocklist
Returns a page of blocklisted releases, the ones Lidarr refuses to grab again after a failed download.

Release, 3 operations

POSTgrab_release
Sends one release from a search result to a download client.
POSTpush_release
Pushes a release Lidarr did not find itself, so it is handled as though an indexer had returned it.
GETsearch_releases
Runs an indexer search and returns the releases found, each with quality, size, seeders, age and the reasons Lidarr would reject it.

Calendar, 2 operations

GETget_calendar_album
Returns one calendar entry by id.
GETlist_calendar_albums
Lists the albums scheduled between two dates, as the calendar view shows them.

Cutoff unmet, 2 operations

GETget_cutoff_unmet_album
Returns one below-cutoff album by id.
GETlist_cutoff_unmet_albums
Returns a page of monitored albums whose existing file is below the profile cutoff.

Language, 2 operations

GETget_language
Returns one language by id.
GETlist_languages
Lists the languages Lidarr can recognise in a release.

Missing, 2 operations

GETget_missing_album
Returns one monitored album that has no file, by id.
GETlist_missing_albums
Returns a page of monitored albums that have no file yet.

Quality definition, 2 operations

GETget_quality_definition
Returns the quality definition with the given id.
GETlist_quality_definitions
Lists the quality definitions defined in Lidarr. Each holds the minimum and maximum size accepted for one quality.

Scheduled task, 2 operations

GETget_scheduled_task
Returns one scheduled task by id.
GETlist_scheduled_tasks
Lists the scheduled tasks with their interval and their last and next run times.

Track, 2 operations

GETget_track
Returns one track with its duration, number and file.
GETlist_tracks
Lists tracks for an artist, an album or an album release.

Backup, 1 operation

GETlist_backups
Lists the database backups on disk.

Disk space, 1 operation

GETlist_disk_space
Reports free and total space for every disk that holds a root folder.

Health check, 1 operation

GETlist_health_checks
Lists the health checks currently failing, each with its source, type and message.

Indexer flag, 1 operation

GETlist_indexer_flags
Lists the flags a release can carry, such as freeleech or internal.

Log file, 1 operation

GETlist_log_files
Lists the log files on disk with their size and last write time.

Log record, 1 operation

GETlist_log_records
Returns a page of log records, filterable by level.

Manual import, 1 operation

GETlist_manual_import_candidates
Lists 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

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

Rename, 1 operation

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

Retag, 1 operation

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

Search, 1 operation

GETsearch_artists_and_albums
Searches MusicBrainz for artists and albums in one call and returns both kinds of result.

System status, 1 operation

GETget_system_status
Returns version, build date, runtime, operating system, configured paths and authentication mode.

Update, 1 operation

GETlist_available_updates
Lists 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.