Rocksky
  1. How-Tos
Rocksky
  • Overview
  • Introduction
  • FAQ
  • How-Tos
    • Migrating to Rocksky Scrobble API
    • Migrating from ListenBrainz to Rocksky
    • How to Use Rocksky with Jellyfin
    • How to Use Rocksky with Navidrome
    • How to Use Rocksky with Pano Scrobbler on Android
    • How to Use Rocksky with Kodi
    • Use Rocksky with Claude Desktop
  • CLI
    • Overview
    • Commands
      • login
      • mcp
      • whoami
      • nowplaying
      • scrobbles
      • search
      • stats
      • artists
      • albums
      • tracks
      • scrobble
      • create apikey
      • help
  • API Reference
    • albums
      • Get User's Albums
      • Get Album
      • Get Several Albums
    • artists
      • Get User's Artists
      • Get Artist
      • Get Several Artists
    • charts
      • Get Scrobbles Per Day
    • playlists
      • Get User's Playlists
      • Get Playlist
    • scrobbles
      • Get Scrobbles
      • Get User's Scrobbles
    • users
      • Find User Profile
    • tracks
      • Get User's Tracks
      • Get Track
      • Get Several Tracks
    • search
      • Search for Item
    • likes
      • Get User's Liked Songs
  1. How-Tos

Use Rocksky with Claude Desktop

This guide will walk you through setting up Rocksky MCP (Model Control Protocol) and using it with Claude Desktop to interact with the Rocksky API.
Screenshot from 2025-04-26 01-28-22.png

Prerequisites#

Node.js and npm installed on your system
Claude Desktop application installed
A Rocksky account (if you don't have one, sign up at rocksky.app)

Setting Up Rocksky MCP#

Step 1: Install Rocksky CLI#

First, install the Rocksky CLI globally using npm:

Step 2: Configure Claude Desktop for Rocksky MCP#

1.
Open Claude Desktop
2.
Go to Settings (gear icon) > Advanced > Model Control Protocol
3.
Enable MCP by toggling the switch to "On"
4.
Click "Edit Configuration" to open the MCP config file
5.
Add the following configuration to the file:
{
  "mcpServers": {
    "rocksky": {
      "command": "rocksky",
      "args": [
        "mcp"
      ]
    }
  }
}
6.
Save the configuration file
7.
Restart Claude Desktop for the changes to take effect

Using Rocksky with Claude#

Once you've set up Rocksky MCP, you can start interacting with the Rocksky API through Claude. Here are some examples of what you can do:

Get Recently Played Tracks#

Simply ask Claude:
What are my recently played tracks?
Claude will use the Rocksky MCP to fetch your scrobble history and display it.

View Your Top Artists#

Ask Claude:
Show me my top artists on Rocksky

Search for Music#

You can search for tracks, artists, or albums:
Search for tracks by Radiohead

View User Stats#

Get your listening statistics:
What are my Rocksky stats?

View Now Playing#

See what's currently playing:
What am I listening to right now?

Advanced Usage#

Viewing Other Users' Data#

You can also view other users' listening data by specifying their username or DID:
Show me the recently played tracks for username.bsky.social

Limiting Results#

You can specify how many results you want to see:
Show me my top 10 tracks

API Keys (For Developers)#

If you're developing with Rocksky, you can create API keys:
Create a new Rocksky API key called "My Application"

Troubleshooting#

If you encounter any issues:
1.
Ensure the Rocksky CLI is properly installed
2.
Verify your MCP configuration is correct
3.
Check if you're logged into your Rocksky account
4.
Restart Claude Desktop

Further Resources#

AT Protocol Documentation
Claude MCP Documentation
Modified at 2025-05-24 12:55:04
Previous
How to Use Rocksky with Kodi
Next
Overview
Built with