Skip to main content
Glama
lastfm-mcp

lastfm-mcp

by dkfancska

Last.fm MCP Server

PyPI - Version

An MCP server for the Last.fm API. Enables LLM agents to access music data: user profiles, listening history, top charts, search, and artist/album/track metadata.

Features

User Tools

  • lastfm_get_user_info — User profile: country, scrobble count, registration date.

  • lastfm_get_recent_tracks — Recently played tracks (including now playing).

  • lastfm_get_user_top_artists — Top artists for a time period.

  • lastfm_get_user_top_albums — Top albums for a time period.

  • lastfm_get_user_top_tracks — Top tracks for a time period.

  • lastfm_get_user_loved_tracks — Loved (favorited) tracks.

Search Tools

  • lastfm_search_artist — Search artists by name.

  • lastfm_search_album — Search albums by name.

  • lastfm_search_track — Search tracks by name.

Artist Tools

  • lastfm_get_artist_info — Artist details: bio, tags, listener/scrobble stats, similar artists.

  • lastfm_get_similar_artists — Similar artists with match scores.

  • lastfm_get_artist_top_tracks — Artist's top tracks.

  • lastfm_get_artist_top_albums — Artist's top albums.

Album Tools

  • lastfm_get_album_info — Album details: tracklist, tags, description.

Track Tools

  • lastfm_get_track_info — Track details: duration, tags, listener/scrobble stats.

  • lastfm_get_similar_tracks — Similar tracks with match scores.

Related MCP server: Claud-Ear

Configuration

You will need a Last.fm API key. Get one for free at last.fm/api/account/create.

Claude Desktop

  1. Open the Claude Desktop configuration file located at:

    • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • On Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. Add the following:

{
  "mcpServers": {
    "lastfm": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "lastfm-mcp",
        "--python",
        "3.10",
        "lastfm-mcp"
      ],
      "env": {
        "LASTFM_API_KEY": "<your-api-key>"
      }
    }
  }
}
  1. Locate the command entry for uv and replace it with the absolute path to the uv executable. This ensures that the correct version of uv is used when starting the server. On a Mac, you can find this path using which uv.

  2. Restart Claude Desktop to apply the changes.

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "lastfm": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "lastfm-mcp",
        "--python",
        "3.10",
        "lastfm-mcp"
      ],
      "env": {
        "LASTFM_API_KEY": "<your-api-key>"
      }
    }
  }
}

Claude Code

claude mcp add lastfm -- uv run --with lastfm-mcp --python 3.10 lastfm-mcp

Make sure LASTFM_API_KEY is set in your environment.

Running Without uv (Using System Python)

If you prefer to use the system Python installation instead of uv, you can install the package from PyPI and run it directly:

  1. Install the package using pip:

    pip install lastfm-mcp
  2. Update your configuration to use the installed script directly:

{
  "mcpServers": {
    "lastfm": {
      "command": "lastfm-mcp",
      "env": {
        "LASTFM_API_KEY": "<your-api-key>"
      }
    }
  }
}

Note: Make sure to use the full path to the lastfm-mcp script if it is not in your system PATH. You can find the path using which lastfm-mcp.

Environment Variables

  • LASTFM_API_KEY (required): Your Last.fm API key.

Parameters

Top chart tools (lastfm_get_user_top_artists, lastfm_get_user_top_albums, lastfm_get_user_top_tracks) support a period parameter:

Value

Period

overall

All time (default)

7day

Last 7 days

1month

Last month

3month

Last 3 months

6month

Last 6 months

12month

Last year

All list tools support pagination via limit and page.

Development

  1. Clone the repository and install dependencies:

    git clone https://github.com/dkfancska/mcp-lastfm.git
    cd mcp-lastfm
    pip install -e .
  2. Copy .env.example to .env and add your API key:

    cp .env.example .env
  3. For testing with the MCP Inspector:

    npx @modelcontextprotocol/inspector lastfm-mcp

License

MIT

Available Tools

16 tools
lastfm_get_album_infoB
Read-onlyIdempotent

Get detailed information about an album.

Returns tracklist, tags, listener stats, and wiki summary.

Inputs: params (required). Returns: result

lastfm_get_artist_infoA
Read-onlyIdempotent

Get detailed information about an artist.

Returns bio, stats, tags, and similar artists.

Inputs: params (required). Returns: result

lastfm_get_artist_top_albumsB
Read-onlyIdempotent

Get the top albums for an artist on Last.fm.

Inputs: params (required). Returns: result

lastfm_get_artist_top_tracksA
Read-onlyIdempotent

Get the top tracks for an artist on Last.fm.

Inputs: params (required). Returns: result

lastfm_get_recent_tracksA
Read-only

Get a user's recently played tracks.

Returns the most recent scrobbles, including currently playing track if any.

Inputs: params (required). Returns: result

lastfm_get_similar_artistsB
Read-onlyIdempotent

Get artists similar to the specified artist.

Inputs: params (required). Returns: result

lastfm_get_similar_tracksA
Read-onlyIdempotent

Get tracks similar to the specified track.

Inputs: params (required). Returns: result

lastfm_get_track_infoA
Read-onlyIdempotent

Get detailed information about a track.

Returns listener stats, tags, album info, and wiki summary.

Inputs: params (required). Returns: result

lastfm_get_user_infoA
Read-onlyIdempotent

Get profile information for a Last.fm user.

Returns user profile data including playcount, registration date, country, and profile URL.

Inputs: params (required). Returns: result

lastfm_get_user_loved_tracksB
Read-onlyIdempotent

Get a user's loved (favorited) tracks.

Inputs: params (required). Returns: result

lastfm_get_user_top_albumsA
Read-onlyIdempotent

Get a user's top albums for a given time period.

Inputs: params (required). Returns: result

lastfm_get_user_top_artistsA
Read-onlyIdempotent

Get a user's top artists for a given time period.

Inputs: params (required). Returns: result

lastfm_get_user_top_tracksA
Read-onlyIdempotent

Get a user's top tracks for a given time period.

Inputs: params (required). Returns: result

lastfm_search_albumB
Read-onlyIdempotent

Search for albums on Last.fm by name.

Inputs: params (required). Returns: result

lastfm_search_artistB
Read-onlyIdempotent

Search for artists on Last.fm by name.

Inputs: params (required). Returns: result

lastfm_search_trackB
Read-onlyIdempotent

Search for tracks on Last.fm by name.

Inputs: params (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 16 tools

    Disambiguation5/5

    Each tool targets a distinct resource (album, artist, track, user) and action (get info, get top, search, similar), with no overlap in purpose. An agent can clearly distinguish between them.

    Naming Consistency5/5

    All tools follow a consistent 'lastfm_<verb>_<resource>' pattern in snake_case, making it predictable and easy to navigate.

    Tool Count4/5

    16 tools is appropriate for a music discovery service covering albums, artists, tracks, and users, though slightly more than the typical 3-15 range. Still well-scoped.

    Completeness4/5

    Covers core read operations for artists, albums, tracks, and users including search and top lists. Lacks write operations (like love/unlove tracks) and some niche endpoints (e.g., tags, events), but the read surface is solid.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Unofficial, read-only access to your Last.fm listening history, charts, loved tracks, and artist, album and track lookups. Connect to https://lastfm-mcp.com/mcp and sign in with Last.fm. Not affiliated with Last.fm.
      53
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Spotify that enables playlist building and music discovery through 19 tools, allowing LLM agents to search tracks/artists/albums, manage playlists, control playback, and access personal listening data.
      20
      46 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for the Last.fm API, exposing artist, album, track, chart, and user data as read-only tools. Supports optional writes, auth, and experimental methods over stdio or HTTP.
      MIT