1. Conduid
  2. Developer Tools
  3. Applemusic
MCP server · Developer Tools

Applemusic

by · github.com/samwang0723/mcp-applemusic

The ultimate 71-tool Apple Music MCP server for macOS: playback, Spotify playlist importer, listening journal, Replay reports, smart DJ crossfades, and AirPlay.

Unclaimed last commit a year ago apple-musicapple-music-replayapplescriptclaude-desktopcursordj-transitionsfast-mcpmacosmcpmcp-servermodel-context-protocolscrobblerspotify-to-apple-music
InstallView source
41Fair

Scored 2 days ago · breakdown

About Applemusic

Applemusic is an MCP server published by samwang0723 in the Developer Tools category: the ultimate 71-tool Apple Music MCP server for macOS: playback, Spotify playlist importer, listening journal, Replay reports, smart DJ crossfades, and AirPlay. It has been installed 0 times through Conduid.

The repository has 2 stars and 1 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx mcp-applemusic

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Applemusic

Powered by Claude · Grounded in docs

I know everything about Applemusic. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

MCP AppleMusic Server

MCP server for controlling Apple Music on macOS.

Overview

This project provides a Model-Context-Protocol (MCP) server that allows you to control the Apple Music application on a macOS device. It works by executing AppleScript commands (osascript) under the hood.

The server is built with TypeScript, using Express.js to handle HTTP connections and the @modelcontextprotocol/sdk for MCP communication.

Note: This server is designed to run directly on a macOS machine, as it depends on osascript to interact with Apple Music.

Features

  • Control Apple Music playback (play, pause, next track).
  • Adjust volume.
  • Search for songs, albums, and artists in your library.
  • Search and immediately play a song.
  • Get the currently playing track name.
  • Exposes functionality as MCP tools.

Requirements

  • Operating System: macOS
  • Runtime: Node.js v20+

⚙️ Setup and Installation

  1. Clone the repository:

    git clone https://github.com/samwang0723/mcp-applemusic.git
cd mcp-applemusic

  2. Install dependencies:

    npm install

  3. Configure environment variables: Create a .env file in the root of the project. You can copy the example if one is provided, or create it from scratch.

    # The port the server will listen on (default: 3000)
PORT=3000

# The logging level (e.g., 'debug', 'info', 'warn', 'error') (default: 'info')
LOG_LEVEL=info

🚀 Usage

Development

To run the server in development mode with hot-reloading (thanks to tsx):

npm run dev

Production

To build and run the server for production:

# 1. Build the TypeScript source code
npm run build

# 2. Start the server
npm start

Once running, the server will be available at http://localhost:3000 (or your configured PORT).

🛠️ Available Tools

The server exposes the following tools for an MCP client to use:

Tool Name Description Parameters
apple-music-set-volume Adjust Apple Music volume level: number (0-10)
apple-music-next-track Play next track None
apple-music-pause Pause music playback None
apple-music-play Resume music playback None
apple-music-search-album Search for tracks by album album: string
apple-music-search-and-play Search and play a song song: string
apple-music-search-song Search for specific songs song: string
apple-music-search-artist Search for tracks by artist artist: string
apple-music-get-current-track Get currently playing track None

🔌 API Endpoints

The server exposes the following HTTP endpoints:

  • GET /health: A health check endpoint. Returns { "status": "ok", "service": "mcp-applemusic-server" }.
  • /mcp (GET, POST, DELETE): The primary endpoint for MCP communication.

🐳 Docker

A Dockerfile is included in this project. You can build a Docker image using:

docker build -t mcp-applemusic .

However, please be aware of the following critical limitation:

⚠️ The Docker container will not function correctly. ⚠️

The server relies on osascript to control Apple Music, which is a macOS-specific utility. Standard Docker images are Linux-based and do not include this utility. Running the server in the provided Docker container will result in errors when any Apple Music tool is called.

This Dockerfile should be seen as a starting template for a generic Node.js application and would require a macOS-based environment to run successfully.

🔬 Development Scripts

  • npm run lint: Lint the code using ESLint.
  • npm run lint:fix: Automatically fix linting issues.
  • npm test: Run tests using Jest (test files need to be created).

README mirrored from the source repository 2 days ago. The original is authoritative.

Questions

About Applemusic

How do I install Applemusic?

Run npx mcp-applemusic, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Applemusic safe to use with an AI agent?

Its trust score is 41 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Applemusic still maintained?

The last commit was a year ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.