Yandex.Disk MCP Server

Yandex Disk MCP server: folders, metadata, copy, move, delete and upload or download links

MCP serverHigh riskRussian stack

gorokhovdenis/yandex-disk-mcp

Install

git clone https://github.com/gorokhovdenis/yandex-disk-mcp.git
cd yandex-disk-mcp
npm install
npm run build

The README also mentions npm install -g yandex-disk-mcp.

This is third-party code. Review the repository files before installing.

What it does

The server connects the agent to the Yandex Disk REST API with an OAuth token. The agent can check used space, get a flat file list and recent uploads, and read file or folder metadata. For changes it can create folders, copy, move, rename and delete to trash or permanently. The server does not transfer file contents: it returns a link, and the actual upload or download happens separately, for example with curl.

Who it is for. For people who keep work files on Yandex Disk and want to organize them through an agent.

Good fit when

  • You want to tidy Disk folders: create a structure and move files
  • You need recent uploads or a free space check
  • You need a download link for a Disk file in a script

Not a fit when

  • You need the agent to upload file contents without a separate command
  • The Disk holds critical data and the token has write access without a backup

Example request

Create /Projects/2026 on Yandex Disk and move all files from /temp there

Limitations

Requires a Yandex OAuth token obtained manually by creating an app at oauth.yandex.ru. Upload and download work only through returned links. There is no content search or public link sharing among the tools. Deletion with the permanently flag cannot be undone.

How to disable. Remove the yandex-disk block from ~/.claude.json or your MCP client config and revoke the token in Yandex ID settings if needed.

MCP

Transport
stdio
Authentication
OAuth
Environment variables
Environment variables
YANDEX_DISK_TOKEN
required, secret
Yandex OAuth token with Disk scopes

Security check

  • Can move, overwrite and permanently delete files on Disk
  • Stores a write-scoped OAuth token in the client config

README in short

The README walks through creating a Yandex OAuth app and getting a token. It offers two install paths, an npm package and a source build, with a Claude Code config example. Each of the ten tools is documented with parameters and a sample prompt. It notes that for uploads the agent gets a link and the transfer happens separately. MIT license.

FAQ

Which scopes should the app get?

The README lists cloud_api:disk.read, cloud_api:disk.write and cloud_api:disk.info. Skip disk.write if you do not need changes.

Does delete erase the file right away?

By default files go to trash. Permanent deletion happens only with the explicit permanently parameter.

Editors’ pick

A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more

CLIHigh risk31K
Editors’ pick

Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server

CLIMedium risk29.7K
Editors’ pick

A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI

MCP serverMedium risk28.1K
Editors’ pick

Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search

PluginHigh risk24K