Glama
Sign In

MCP-AppleMusic

by kennethreitz
Verified
GitHub
Python
26
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

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

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
F
license - not found
-
quality - not tested

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