Skip to main content
Glama

Longplay MCP

by nighthawk

Longplay

Control Longplay and interact with your music library

Overview

Version: 1.0.0
Author: Adrian Schoenig (adrian@schoenig.me)
Homepage: https://longplay.rocks

Compatibility

  • Platform: macOS (darwin)

  • Claude Desktop: >= 0.10.0

Server Configuration

Type: Binary
Entry Point: mcp-server
Command: /Applications/Longplay.app/Contents/Helper/mcp-server

Available Tools

Library Management

  • list_albums - Get the playlists and (nearly) complete albums in the user's music library or in a specified collection. Each album (or playlist) is returned with title, artist, and release year, where available.

  • find_albums - Search for albums and playlists in the user's music library using advanced filters. Allows filtering by album attributes such as name, artist, genre, rating, etc. Note also that the kind input allows filtering the results by just albums or playlists.

  • list_collections - Get the list of the user's collections. Collections contain a list of albums and playlists, and might either be manually created collections or smart collections that update dynamically.

  • create_collection - Create a new collection of the provided name. In filter input is provided, it'll be a smart collection.

  • update_collection - Updates the existing specified collection:

    • Update the name

    • Add/remove albums, if the collection is a custom (i.e., non-smart) collection

    • Update filter, if the collection is a smart collection

Playback Control

  • play_album - Plays the specified album, unless no id is specified. Then a random album is played. Albums are always played first track to last, as the artist intended. Though tracks that are below the user's minimum rating might be skipped. Can nominate whether to play the album now, next (in the queue), or last (in the queue).

  • shuffle - Starts Infinite Album Shuffle, either of a specified collection or of a specified sort order of the entire library. If neither is provided, the sort order random is used, and if both are provided, the order is ignored.

  • control_player - Controls the app's media player:

    • playpause: toggle the playing/paused state of the current album/playlist

    • pause: pauses the current album/playlist

    • stop: stop playback

    • skip: skip the current album/playlist, and either play the next in the queue or a random one

    • status: return the current playing status without changing player state

Display

  • show_in_app - Shows the albums passed into this action as an ad-hoc collection, with an optional title. Albums can either be passed directly via their IDs, or via a filter. If a filter is provided, the albums will update live as the criteria change. Either the albums or the filter are required as input. If both are provided, then the filter takes precedence.

A local MCP server to control and interact with Longplay, an album-focussed music player for macOS. The MCP server is shipped with the app, and can be installed in Claude by using the provided DXT/MCPB file.

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nighthawk/longplay-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server