mcp-applemusic
Language:
Python
Stars:
28
Forks:
5
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
- Clone the repository:
git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic
- Install development dependencies:
pip install -e ".[dev]"
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - 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
Publisher info
Kenneth Reitz
I wrote Requests: HTTP for Humans and Pipenv. The only thing I really care about is user experience.
More MCP servers built with Python
An MCP (Model Context Protocol) server that provides access to Bing Webmaster Tools functionality
This MCP server provides access to real-time water data from the USGS Water Services API. It allows you to fetch instantaneous water measurements including stream flow, gage height, temperature, and other water quality parameters from thousands of monitoring stations across the United States.