Last.fm MCP Server
A Model Context Protocol (MCP) server that provides access to Last.fm music data and discovery capabilities.
Available Tools
Artist Tools
search_artists- Search for artists by nameget_artist_info- Get detailed artist information and biographyget_artist_top_albums- Get an artist's most popular albumsget_artist_top_tracks- Get an artist's most popular tracks
Album Tools
search_albums- Search for albums by nameget_album_info- Get detailed album information and tracklistget_album_top_tags- Get tags associated with an album
Track Tools
search_tracks- Search for tracks by nameget_track_info- Get detailed track informationget_similar_tracks- Find tracks similar to a given trackget_track_top_tags- Get tags associated with a track
User Tools
get_user_info- Get user profile informationget_user_recent_tracks- Get a user's recently played tracksget_user_top_artists- Get a user's most played artistsget_user_top_albums- Get a user's most played albumsget_user_top_tracks- Get a user's most played tracksget_user_loved_tracks- Get tracks a user has marked as loved
Chart Tools
get_top_artists- Get global top artistsget_top_tracks- Get global top tracksget_top_tags- Get popular music tags
Tag Tools
get_tag_info- Get information about a music tagget_tag_top_artists- Get top artists for a tagget_tag_top_albums- Get top albums for a tagget_tag_top_tracks- Get top tracks for a tagget_tag_weekly_charts- Get weekly chart data for a tag
Write Operations (Authentication Required)
scrobble_track- Scrobble a track to user's profilelove_track- Mark a track as lovedunlove_track- Remove love from a trackupdate_now_playing- Update what's currently playingadd_track_tags- Add tags to a trackremove_track_tag- Remove a tag from a track
Authentication Tools
get_auth_token- Get authentication token for user loginget_auth_session- Convert token to session for API access
Setup
Prerequisites
- Get Last.fm API credentials at Last.fm API
- Copy
.env.exampleto.envand add your credentials:LASTFM_API_KEY=your_actual_api_key_here LASTFM_SHARED_SECRET=your_actual_shared_secret_here
VS Code/Cursor Setup
Option 1: Docker (Recommended)
First build the image:
docker build -t lastfm-mcp .
Then add to your VS Code/Cursor MCP configuration:
{
"mcpServers": {
"lastfm-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env-file",
"/path/to/your/.env",
"lastfm-mcp"
]
}
}
}
Important: Replace /path/to/your/.env with the actual path to your .env file.
Option 2: UV
Add to your VS Code/Cursor MCP configuration:
{
"mcpServers": {
"lastfm-mcp": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/your/project",
"run",
"--env-file",
".env",
"mcp_server.py"
]
}
}
}
Important:
- Replace
/path/to/uvwith the actual path to your UV installation. Runwhich uvin your terminal to find the path (e.g.,/usr/local/bin/uv,/home/user/.local/bin/uv, or justuvif it's in your PATH) - Replace
/path/to/your/projectwith the actual absolute path to your project directory