Skip to content
Back to search

mcp-applemusic

An experimental MCP server for controlling Apple Music.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kennethreitz--mcp-applemusic/badge.svg)](/listings/kennethreitz--mcp-applemusic)

HTML

<a href="/listings/kennethreitz--mcp-applemusic"><img src="/api/listings/kennethreitz--mcp-applemusic/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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": ["-p", "3.13", "-n", "mcp-applemusic"]
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 97 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/kennethreitz-mcp-applemusic-badge.png)](https://mseep.ai/app/kennethreitz-mcp-applemusic)
  2. # MCP-AppleMusic
  3. A FastMCP server implementation for controlling Apple Music (formerly iTunes) on macOS through AppleScript commands.
  4. ## Requirements
  5. - Python 3.13+
  6. - macOS with Apple Music app installed
  7. - MCP library ≥1.2.1
  8. ## Installation
  9. First, ensure you have uv installed:
  10. ```bash
  11. $ brew install uv
  12. ```
  13. Then, with **Claude Desktop**, add the following to `claude_desktop_config.json`:
  14. ```json
  15. {
  16. "mcpServers": {
  17. "iTunesControlServer": {
  18. "command": "uvx",
  19. "args": ["-p", "3.13", "-n", "mcp-applemusic"]
  20. }
  21. }
  22. }
  23. ```
  24. ## Available Commands
  25. The following commands are available through the MCP server:
  26. ```python
  27. itunes_play() # Start playback
  28. itunes_pause() # Pause playback
  29. itunes_next() # Skip to next track
  30. itunes_previous() # Go to previous track
  31. itunes_search(query) # Search library for tracks
  32. itunes_play_song(song) # Play specific song
  33. itunes_create_playlist(name, songs) # Create new playlist
  34. itunes_library() # Get library statistics
  35. ```
  36. ## Usage
  37. Start the server:
  38. ```bash
  39. python server.py
  40. ```
  41. Example interactions:
  42. ```python
  43. # Search for a song
  44. results = itunes_search("Hey Jude")
  45. # Create a new playlist
  46. itunes_create_playlist("Beatles Favorites", ["Yesterday", "Hey Jude", "Let It Be"])
  47. # Play a specific song
  48. itunes_play_song("Hey Jude")
  49. ```
  50. ## Development
  51. 1. Clone the repository:
  52. ```bash
  53. git clone https://github.com/yourusername/mcp-applemusic.git
  54. cd mcp-applemusic
  55. ```
  56. 2. Install development dependencies:
  57. ```bash
  58. pip install -e ".[dev]"
  59. ```
  60. ## Contributing
  61. 1. Fork the repository
  62. 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
  63. 3. Commit your changes (`git commit -m 'Add amazing feature'`)
  64. 4. Push to the branch (`git push origin feature/amazing-feature`)
  65. 5. Open a Pull Request
  66. ## License
  67. This project is licensed under the MIT License - see the LICENSE file for details.
  68. ## Notes
  69. - This tool only works on macOS systems due to its AppleScript dependency
  70. - Requires Apple Music (formerly iTunes) to be installed

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.