applemusic-mcp

applemusic-mcp — MCP-сервер сообщества (автор — epheterson). Apple Music: плейлисты, медиатека, каталог и воспроизведение. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
epheterson
Лицензия
MIT
Транспорт
stdio
Авторизация
other
ОС
Не указана
Языки
python

Уровень риска: high

Меняет плейлисты, медиатеку и оценки в аккаунте Apple Music; на уровнях api и web использует сохранённую сессию; на уровне full нажимает кнопки в приложении «Музыка».

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"Apple Music\": {\n      \"command\": \"applemusic-mcp\",\n      \"args\": [\"serve\", \"--level\", \"music\"]\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

applemusic-mcp — неофициальный MCP-сервер для Apple Music. Он даёт Claude, Cursor, Cline, Windsurf и другим MCP-клиентам управление плейлистами, медиатекой, каталогом, рекомендациями, воспроизведением и очередью «Далее». Работает на macOS, Windows и Linux; нужен Mac или подписка Apple Music. Примеры запросов: «Создай плейлист Road Trip и заполни его бодрым альтернативным роком 90-х» или «Включи мой плейлист для тренировок вперемешку и поставь следующей Bohemian Rhapsody».

Семь инструментов, каждый принимает действие (action):

  • playlist — список, папки, треки, поиск, создание, добавление, копирование, перемещение, удаление треков и плейлистов, переименование.
  • library — поиск, добавление, просмотр, избранное, недавно прослушанное и добавленное, оценки, удаление, снимок медиатеки.
  • catalog — поиск и сведения об альбомах, песнях, артистах, жанры, подсказки.
  • discover — рекомендации, часто слушаемое, чарты, похожие артисты, персональные станции.
  • playback — воспроизведение трека, альбома, плейлиста или ссылки, управление, текущий трек, громкость, перемешивание, повтор, выбор устройства AirPlay.
  • queue — очередь «Далее»: просмотр, добавление следующим или последним, удаление, переход, очистка, автовоспроизведение.
  • config — статус, вход и выход, настройки, журнал аудита.

Уровни доступа задаются флагом --level в конфиге клиента, и ассистент не может их изменить: music — только приложение «Музыка» на Mac, без сети и браузера; api — плюс сервис Apple Music через интернет (каталог, рекомендации, Windows и Linux); web — плюс веб-плеер в Safari или Chrome (очередь, воспроизведение не на Mac); full — всё, включая нажатия внутри приложения. Флаг --allow-ui разрешает нажатия в приложении «Музыка» через универсальный доступ macOS. Без --level сейчас действует full.

Кому подойдёт

  • Подписчикам Apple Music, которые хотят собирать плейлисты и управлять музыкой голосом ассистента.
  • Владельцам Mac с большой локальной медиатекой: оценки, папки, AirPlay.
  • Пользователям Windows и Linux с подпиской — через API и веб-плеер.

Похожие серверы — в категории медиа и творчество.

Установка

Нужен Python 3.10+. Для Claude Code достаточно одной команды с uvx. Для других клиентов установите пакет pipx install applemusic-mcp (или pip install applemusic-mcp), а для веб-плеера Chrome — playwright install chromium. Уровни api и web требуют входа командой applemusic-mcp login: на Mac он берёт сессию из Safari (войдите на music.apple.com и включите в меню «Разработка» разрешение JavaScript из Apple Events), в Windows и Linux открывает Chrome. Пароль инструмент не видит. На Windows и Linux начинайте с уровня api.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add "Apple Music" -- uvx applemusic-mcp serve --level music

Тот же JSON README приводит для Cursor, Cline и Windsurf. Замените music на api или web, чтобы открыть больше возможностей, и перезапустите клиент.

Проверка

Спросите: «Покажи мои плейлисты Apple Music» или «Включи избранное». Команда applemusic-mcp status показывает статус входа и уровень доступа.

Примеры задач

Что я слушал в последнее время и что сейчас в топе чартов?
Создай плейлист «Для работы» из 20 инструментальных треков в стиле lo-fi и включи его.

Риски

  • Изменения в медиатеке. Ассистент создаёт, переименовывает и удаляет плейлисты, удаляет треки из медиатеки и меняет оценки.
  • Сессия Apple Music. Сохранённый вход даёт доступ к аккаунту; applemusic-mcp reset --force удаляет учётные данные.
  • Управление интерфейсом. На уровне full или с --allow-ui сервер нажимает кнопки в приложении «Музыка» через универсальный доступ — начинайте с уровня music.
  • Проект не связан с Apple; соблюдайте условия Apple Music.

Частые вопросы

Нужна ли подписка Apple Music?

На Mac с локальной медиатекой — нет; для каталога и работы в Windows и Linux — да.

Может ли ассистент сам повысить уровень доступа?

Нет, уровень задаётся только в конфиге клиента.

Работает ли очередь «Далее»?

Да, на уровне web через Safari на Mac или Chrome на других системах.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

FunASR

Локальная расшифровка аудио моделями FunASR и SenseVoice.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники