Yandex Disk MCP (Antiloop)
Yandex Disk MCP Server
Yandex Disk MCP server: files and folders, public links, upload from URL, trash and search, with Docker support
Install
npm install
npm run buildFirst clone github.com/Antiloop-git/yandex-disk-mcp and enter the folder.
This is third-party code. Review the repository files before installing.
What it does
The server uses the Yandex Disk REST API with an OAuth token. The agent checks disk usage, browses folders, reads metadata, and creates, copies, moves and deletes files. It can return download or upload links, upload a file from an external URL, and publish or unpublish resources. It handles the trash: listing, restoring and emptying, plus search by file type and recently uploaded files.
Who it is for. People who keep work files on Yandex Disk and want an agent to help organize them.
Good fit when
- You need to sort files into folders or rename a batch
- You need to share a file via a public link quickly
- You need to restore an accidentally deleted file from the trash
Not a fit when
- The disk holds sensitive data and the agent must not delete or publish files
- You need direct local file upload: the server only returns an upload link
Example request
What is in my Yandex Disk trash? Restore the last deleted fileLimitations
You need to create an app at oauth.yandex.ru and get a token with Disk permissions. The server is built from source with Node.js or in Docker; this author has no npm package, and the npm name yandex-disk-mcp belongs to a different project. The repo has no license file; the README states MIT.
How to disable. Remove the yandex-disk block from the MCP config and revoke the token in your app settings at oauth.yandex.ru.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| YANDEX_DISK_TOKEN required, secret | OAuth token with Yandex Disk permissions |
Security check
- Can delete files permanently and empty the trash
- Can make files publicly accessible
- The token grants access to the whole disk
README in short
The Russian README describes each tool, explains getting an OAuth token step by step and gives configs for Claude Desktop, Claude Code and other clients. It covers running in Docker and via docker-compose with the token from .env. It includes sample prompts. The npx option it mentions refers to a future npm release.
FAQ
Which permissions should the app get?
The README lists cloud_api:disk.app_folder, disk.read, disk.write and disk.info. Grant only what you need.
Can I run it without Node.js installed?
Yes, build the image with docker build -t yandex-disk-mcp . and use docker run with the token variable in the client config.
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