Skip to main content
Glama
Sign In
enesjakozh

MCP-AppleMusic

by kennethreitz
GitHub
Python
MIT License
30
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Enables control of Apple Music on macOS through AppleScript commands, including playback control, library search, song selection, and playlist creation.

  • Provides legacy support for controlling iTunes through AppleScript commands, offering functionality for playback control, library management, searching, and playlist creation.

  • Leverages macOS-specific AppleScript capabilities to enable music playback control and library management for Apple Music/iTunes applications.

MCP-AppleMusic

A FastMCP server implementation for controlling Apple Music (formerly iTunes) on macOS through AppleScript commands.

Requirements

  • Python 3.13+
  • macOS with Apple Music app installed
  • MCP library ≥1.2.1

Installation

First, ensure you have uv installed:

$ brew install uv

Then, with Claude Desktop, add the following to claude_desktop_config.json:

{ "mcpServers": { "iTunesControlServer": { "command": "uvx", "args": ["-n", "mcp-applemusic"] } } }

Available Commands

The following commands are available through the MCP server:

itunes_play() # Start playback itunes_pause() # Pause playback itunes_next() # Skip to next track itunes_previous() # Go to previous track itunes_search(query) # Search library for tracks itunes_play_song(song) # Play specific song itunes_create_playlist(name, songs) # Create new playlist itunes_library() # Get library statistics

Usage

Start the server:

python server.py

Example interactions:

# Search for a song results = itunes_search("Hey Jude") # Create a new playlist itunes_create_playlist("Beatles Favorites", ["Yesterday", "Hey Jude", "Let It Be"]) # Play a specific song itunes_play_song("Hey Jude")

Development

  1. Clone the repository:
git clone https://github.com/yourusername/mcp-applemusic.git cd mcp-applemusic
  1. Install development dependencies:
pip install -e ".[dev]"

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Notes

  • This tool only works on macOS systems due to its AppleScript dependency
  • Requires Apple Music (formerly iTunes) to be installed

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Facilitates controlling Apple Music on macOS via AppleScript through MCP commands, allowing users to manage playback, search for tracks, and create playlists.

  1. Requirements
    1. Installation
      1. Available Commands
        1. Usage
          1. Development
            1. Contributing
              1. License
                1. Notes

                  Related Resources

                  Related MCP Servers

                  • MCP Spotify Server

                    superseoworld
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables interaction with Spotify's music catalog via the Spotify Web API, supporting searches, artist information retrieval, playlist management, and automatic token handling.
                    Last updated -
                    26
                    547
                    2
                    TypeScript
                    MIT License

                  • Apple MCP Server

                    Dhravya
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
                    Last updated -
                    6
                    756
                    1,385
                    TypeScript
                    MIT License
                    • Apple

                  • Spotify MCP Server

                    obre10off
                    -
                    security
                    -
                    license
                    -
                    quality
                    A Model Context Protocol server that enables controlling Spotify playback through natural language commands in MCP clients like Cursor or Claude for Desktop.
                    Last updated -
                    1
                    TypeScript

                  • Spotify MCP Server

                    rakshitha2207
                    -
                    security
                    F
                    license
                    -
                    quality
                    Integrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.
                    Last updated -
                    JavaScript

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  ID: 5tfuto5q19