Yandex Disk (BYOK) — connector documentation
- MCP endpoint:
https://byok-yandex-disk.connectorbay.com/mcp - REST API:
POST https://byok-yandex-disk.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-yandex-disk.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own Yandex Disk Yandex OAuth token with Yandex Disk read access, sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-yandex-disk.connectorbay.com/health· Tool schemas:https://byok-yandex-disk.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-yandex-disk · agent@connectorbay.com
What Yandex Disk (BYOK) is for
Yandex Disk (BYOK) lets an AI assistant read your own Yandex Disk data through the Yandex Disk API with a key you supply (Yandex OAuth token with Yandex Disk read access). Read-only: 6 tools (get_disk_info, list_folder, list_all_files, list_recent_files, list_trash, get_public_resource). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to cloud-api.yandex.net. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Yandex Disk. Yandex Disk and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "How much space is left on my Yandex Disk?"
- "What is in my Yandex Disk folder /Documents?"
- "List all the images on my Yandex Disk"
- "Which files did I upload to Yandex Disk most recently?"
- "What is in my Yandex Disk trash?"
- "What is inside the shared Yandex Disk folder https://disk.yandex.com/d/AaaBbb1122Ccc?"
What it does
get_disk_info: Show total, used and trash space (bytes) of the Yandex Disk and the paths of its system folders.list_folder: Describe a file or folder on Yandex Disk by path and list the entries inside a folder (folders first). Use 'disk:/' for the root.list_all_files: List every file on the Disk as one flat alphabetical list, optionally only some kinds (images, documents, video ...), with size, type and dates.list_recent_files: List the most recently uploaded files, newest first, optionally only some kinds.list_trash: List what is in the Disk's Trash (use '/' for the Trash root) with names, original paths, sizes and deletion times.get_public_resource: Describe a published file or folder from its public link or key (no token rights on the owner's Disk needed), listing folder contents.
BYOK key
You bring your own Yandex Disk Yandex OAuth token with Yandex Disk read access (https://yandex.com/dev/disk-api/doc/en/concepts/quickstart#quickstart__oauth). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to cloud-api.yandex.net over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://yandex.com/dev/disk-api/doc/en/ (the API this connector calls, with a BYOK key)
Live from the Yandex Disk API (cloud-api.yandex.net) with a BYOK key; documentation: https://yandex.com/dev/disk-api/doc/en/. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Yandex Disk. Yandex Disk and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Yandex Disk account.
Built for: Worldwide. Languages: English.