ListenBrainz

Sync listening history from Spotify and other services, explore your music taste, and get personalized recommendations.

Setup

Connect the ListenBrainz toolkit by configuring your ListenBrainz user ID, and optionally an API token if you want the toolkit to create or modify playlists on your behalf. This toolkit uses key-based authentication — no OAuth login is required.

Prerequisites

Before configuring the ListenBrainz toolkit, ensure you have:

Configured an MCP server in your toolforest.io dashboard.
A free ListenBrainz account.

🎧 Bring in your Spotify history

ListenBrainz can ingest your listens directly from Spotify (and Apple Music, last.fm, and others). Connect the services you use under Settings → Music Services in your ListenBrainz account, and toolforest.io will see your listens flowing in via your ListenBrainz user ID.

Configuration Fields

Field	Required	Description
ListenBrainz User ID	Yes	Your public ListenBrainz username (the name in your profile URL, e.g. `listenbrainz.org/user/your-name`).
ListenBrainz API Token	No	Required only if you want the toolkit to create or modify playlists on your behalf. Without it, you can still read your listening history, stats, and recommendations.

Setup Steps

Step 1: Find Your ListenBrainz User ID

Sign in at listenbrainz.org. Your user ID is the username shown in your profile URL — it’s whatever appears after /user/ (e.g. https://listenbrainz.org/user/your-name).

Step 2: (Optional) Get a ListenBrainz API Token

Skip this step if you only want to read data. To enable playlist creation:

Visit your ListenBrainz profile settings.
Locate the User token section.
Copy the token.

Step 3: Configure in toolforest.io

Navigate to your MCP server panel in the toolforest.io dashboard.
Locate the ListenBrainz toolkit.
Click the Configure button.
Paste your ListenBrainz User ID (required) and API Token (optional).
Submit the form.

Step 4: Confirmation

The toolkit status will change to Connected and you can begin querying your listening data immediately.

Managing Your Connection

Reconfigure

To update your user ID or API token, click the ⋮ (three-dot button) and select Reconfigure.

Disconnect

To disconnect the toolkit:

Click the Disconnect button in your MCP server panel.
toolforest.io will delete the stored credentials.

🔒 Security and Privacy

Your ListenBrainz user ID and API token are both encrypted at rest. The token is only decrypted when your AI assistant makes a write request to ListenBrainz on your behalf — read-only operations using just your user ID never require the token.

Capabilities

Category	Capabilities
Listening History	Recent listens, full play history with timestamps, filtering by artist/track/release
Stats	Top artists, releases, and recordings over configurable time ranges (week, month, year, all-time)
Recommendations	Personalized track and artist recommendations based on your listening profile
Playlists (token required)	Create new playlists, add tracks to existing playlists, manage playlist metadata
Discovery	Explore similar artists, related releases, and popular tracks across the ListenBrainz community