Yandex Disk MCP server for Claude.ai
MCP Yandex Disk Server
A small read-focused MCP server for Yandex Disk: folder listings, file search, download links and public links
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Uses an OAuth token with Disk write scope even though the README only covers reads
- The download link returned to the agent grants temporary access to the file's contents
Install
Manual install
Deploy the repo on Railway, set YANDEX_OAUTH_TOKEN and PORT=8080, then add a custom connector in Claude.ai pointing to https://<railway-url>/mcp/sse.
This is third-party code. Review the repository files before installing.
What it does
The Python server gives an agent access to Yandex Disk via an OAuth token: folder listings, file search by type such as documents or images, temporary download links, working with already-published public links like disk.yandex.ru/d, and reading text files. Every capability listed in the README is read-only; there is no mention of write or delete operations. The server deploys to Railway with one click and answers an MCP client at /mcp/sse.
Who it is for. For people who want a simple way to let an agent read files from a personal Yandex Disk.
Good fit when
- You want the agent to find and read a text file on the Disk
- You need a download link or a public link for a file
- Deploying on Railway without your own server works for you
Not a fit when
- You need to upload, delete or move files: the server does not offer that
- You need the vendor's official server, not a single-author third-party project
Example request
Find all documents in the Reports folder on the Disk and open the most recent oneLimitations
The OAuth token is requested with both read and write Disk scopes, even though the README only describes reads: grant the minimum scope you can. The free Railway plan needs your own billing setup. There is no license file, and the short README does not document error handling or pagination.
How to disable. Remove the connector in Claude.ai (Settings, Connectors) and stop or delete the service in Railway.
MCP
- Transport
- sse
- Authentication
- API key
| Environment variables | |
|---|---|
| YANDEX_OAUTH_TOKEN required, secret | Yandex Disk OAuth token |
| PORT required | Server port, 8080 in the example |
Security check
- Uses an OAuth token with Disk write scope even though the README only covers reads
- The download link returned to the agent grants temporary access to the file's contents
README in short
The short README lists five server capabilities, gives four steps to deploy on Railway with two environment variables, explains getting a Yandex Disk OAuth token, and gives the SSE connection address for Claude.ai.
FAQ
Can the server upload or delete a file?
Based on the README, no: it only offers listing, search, download links, public links and reading text files.
Where do I get an OAuth token?
Register an app at oauth.yandex.ru with cloud_api:disk.read and cloud_api:disk.write scopes and get a token via the authorization link.
Related
A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes
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