Yandex.Disk MCP Server
Yandex Disk MCP server: folders, metadata, copy, move, delete and upload or download links
Install
git clone https://github.com/gorokhovdenis/yandex-disk-mcp.git
cd yandex-disk-mcp
npm install
npm run buildThe 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 thereLimitations
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 | |
|---|---|
| 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.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search