yadisk-mcp

MCP-сервер для Яндекс Диска — управляй файлами, папками, публикацией и корзиной через Claude или любой MCP-совместимый клиент.

English version

Особенности

• ⚡ Полностью асинхронный — все операции неблокирующие, параллельные запросы работают без задержек
• 🚀 Фоновая загрузка больших файлов — отправь задачу и сразу получи job_id; прогресс и статус доступны в любой момент
• 📊 Трекинг прогресса — процент выполнения, загружено байт, имя файла для каждой фоновой задачи
• 🗂️ 22 инструмента — полное покрытие API Яндекс Диска: файлы, папки, поиск, публикация, корзина

Инструменты

Информация и поиск

Файловые операции

Загрузка и скачивание

Публикация

Корзина

Получение токена

Шаг 1 — Создай OAuth-приложение на Яндексе

1. Зайди на oauth.yandex.ru → Создать приложение → Для авторизации пользователей
2. Введи любое название, загрузи иконку (обязательно)
3. На шаге Платформы выбери Веб-сервисы, Callback URL:

   https://oauth.yandex.ru/verification_code
   

4. На шаге Права в поле Дополнительные добавь по одному:
   • cloud_api:disk.read
   • cloud_api:disk.write
   • cloud_api:disk.app_folder
   • cloud_api:disk.info
5. Завершил — получишь Client ID и Client Secret

Шаг 2 — Получи токен

Открой в браузере (замени <CLIENT_ID> на свой):

https://oauth.yandex.ru/authorize?response_type=code&client_id=<CLIENT_ID>

Авторизуй приложение, получи код и обменяй его на токен:

curl -X POST https://oauth.yandex.ru/token \
  -d "grant_type=authorization_code" \
  -d "code=<CODE>" \
  -d "client_id=<CLIENT_ID>" \
  -d "client_secret=<CLIENT_SECRET>"

Используй access_token из ответа как YANDEX_DISK_TOKEN. Токен действует 1 год.

Вспомогательный скрипт

python3 get_token.py

Установка

pip install yadisk-mcp

Или из исходников:

git clone https://github.com/Patr56/yadisk-mcp
cd yadisk-mcp
pip install -e .

Настройка

Для работы нужен OAuth-токен Яндекса — как его получить, смотри в разделе Получение токена.

Claude Code (CLI)

claude mcp add yadisk -e YANDEX_DISK_TOKEN=your_token_here -- yadisk-mcp

Или вручную в ~/.claude.json:

{
  "mcpServers": {
    "yadisk": {
      "command": "yadisk-mcp",
      "env": {
        "YANDEX_DISK_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop

В claude_desktop_config.json:

{
  "mcpServers": {
    "yadisk": {
      "command": "yadisk-mcp",
      "env": {
        "YANDEX_DISK_TOKEN": "your_token_here"
      }
    }
  }
}

OpenClaw / другой агент

{
  "mcp": {
    "servers": {
      "yadisk": {
        "command": "yadisk-mcp",
        "env": {
          "YANDEX_DISK_TOKEN": "your_token_here"
        }
      }
    }
  }
}

Примеры использования

После настройки можно говорить Claude:

«Покажи что у меня на Яндекс Диске» «Создай папку /Бэкапы/2026-04» «Загрузи файл /home/user/video.mp4 на диск в папку /Видео» «Опубликуй /Документы/презентация.pdf и дай ссылку» «Загрузи большой файл в фоне и сообщи когда закончится» «Очисти корзину» «Найди все PDF-файлы»

Лицензия

MIT