🎵 Spotify MCP Server for AI Agents

Give your AI assistant the power to control your Spotify!

This Actor is a Model Context Protocol (MCP) server that creates a seamless bridge between your Spotify account and AI agents (like Claude Desktop). By providing your Spotify credentials, your AI will be able to search for music, analyze your listening history, and automatically create custom playlists for you directly from the chat interface.

🛠️ Included AI Tools

Once connected, your AI assistant will automatically understand how to use these tools:

• search_spotify: Search the entire Spotify catalog for tracks and artists.
• get_recently_played: Read your last 10-50 played tracks to analyze your current mood or favorite genres.
• create_playlist: Generate a brand new public or private playlist on your account.
• add_tracks_to_playlist: Seamlessly add recommended tracks into your newly created playlists.

---

🚀 How to Set Up (The "No-Code" Way)

Because Spotify protects your private data, you need to provide 3 specific keys to give your AI access: a Client ID, a Client Secret, and a Refresh Token.

Don't worry—you don't need to be a coder to get them! Just follow these two steps:

Step 1: Get your Client ID & Client Secret from Spotify

First, we need to create a free "Developer App" on Spotify just for you.

1. Go to the Spotify Developer Dashboard and log in.
2. Click the Create app button.
3. Fill out the form:
   • App name: My AI Assistant (or whatever you like)
   • App description: Connecting my AI to Spotify
   • Redirect URIs: You MUST paste this exact link: https://spotify-refresh-token-generator.onrender.com/callback and click the Add button.
   • Check the boxes for Web API and Web Playback SDK.
   • Agree to the terms and click Save.
4. On the next page, click Settings. Here you will see your Client ID and Client Secret. Keep this page open; you will need to copy these!

Step 2: Get your Permanent Refresh Token

To let your AI view your history and make playlists without you logging in every day, you need a Refresh Token. We will use a free web tool to generate this securely.

1. Go to the Spotify Refresh Token Generator.
2. Copy your Client ID and Client Secret from the Spotify page (Step 1) and paste them into the text boxes on the generator website.
3. Click Authorize with Spotify.
4. A secure Spotify login screen will appear. Log in and click Agree to grant your AI access to your account.
5. The site will magically generate your permanent Refresh Token.

Finally, paste all three keys (Client ID, Client Secret, and Refresh Token) into the Apify Input boxes and hit Start!

---

🔌 How to Connect to Claude Desktop

Once your Apify Actor is built and running, you can plug it straight into Claude Desktop.

1. Get your Apify Personal API Token from Settings -> Integrations in the Apify Console.
2. Open Claude Desktop, go to Settings -> Developer -> Edit Config.
3. Add this code to the configuration file (replace YOUR_APIFY_USERNAME with your actual Apify username and paste your API token):

{
  "mcpServers": {
    "spotify-apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-cli",
        "run",
        "YOUR_APIFY_USERNAME/spotify-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "paste_your_apify_api_token_here"
      }
    }
  }
}