yacli Yandex

English

Use the yacli MCP server for Yandex Mail, Disk, and Calendar workflows.

Summary

• Use this skill for Yandex Mail, Disk, and Calendar through yacli
• It supports inbox triage, search and read flows, replies, Disk uploads and sharing, and calendar lookup or scheduling
• It requires a working yacli MCP server and at least one authenticated Yandex account

Prerequisites

• A working yacli MCP server must already be configured in OpenClaw
• At least one Yandex account must already be authenticated for the services you want to use
• If yacli is not installed or wired yet, read references/install.md and references/mcporter-config.md
• If tools are missing or auth is incomplete, read references/setup.md

Account selection

• If the user specifies an account alias or email, use it
• Otherwise start with yacli.account.current
• If no current account is set, call yacli.account.list
• Before claiming auth is broken, call yacli.auth.status

Critical tool naming rule

• Use concrete MCP tool ids only:
  • yacli.account.current
  • yacli.mail.list
  • yacli.disk.upload
  • yacli.calendar.events
• Do not call generic categories such as mail, disk, calendar, goal.route, or bare yacli
• If you are calling tools through mcporter CLI, dotted tool names must be passed with:
  • mcporter call --server yacli --tool yacli.mail.list --args '{"folder":"INBOX"}'
• Do not use selector syntax like mcporter call yacli.mail.list ... for this server, because some runtimes split at the first dot and end up calling unsupported tools like mail

Mail

1. yacli.mail.folders
2. yacli.mail.list or yacli.mail.search
3. yacli.mail.read
4. Then only if needed:
   • yacli.mail.reply
   • yacli.mail.forward
   • yacli.mail.send

Attachments and invites

• yacli.mail.attachment.export to save an attachment on the MCP host
• yacli.mail.invite.inspect to parse a calendar invite before acting on it
• yacli.mail.invite.create_event only after explicit user approval

Disk

1. yacli.disk.info or yacli.disk.list
2. yacli.disk.mkdir if a target directory is needed
3. Then one of:
   • yacli.disk.upload for a private upload
   • yacli.disk.upload_link for upload plus immediate public link
   • yacli.disk.publish or yacli.disk.unpublish for existing files
   • yacli.disk.download to export a private file to the MCP host
4. Use yacli.mail.send_link or yacli.mail.send_published_link when the user wants a shared file sent by email

Calendar

1. yacli.calendar.calendars
2. yacli.calendar.events
3. Then only if needed:
   • yacli.calendar.create
   • yacli.calendar.delete

• Use an explicit calendar id for writes
• Do not assume a default calendar if listing is available

Safety rules

• Do not send email without explicit user confirmation of recipients and content unless the user explicitly asked to send it now
• Do not publish private files or create public links without explicit user approval
• Do not create or delete calendar events without explicit user approval
• For destructive or externally visible actions, prefer read/list first, summarize the intended action, then execute

Русский

Используйте yacli MCP server для работы с Yandex Mail, Disk и Calendar.

Кратко

• Используйте этот skill для Yandex Mail, Disk и Calendar через yacli
• Он поддерживает разбор входящих писем, поиск и чтение сообщений, отправку ответов, загрузку файлов на Disk, их совместное использование, а также поиск событий в Calendar и планирование встреч
• Для работы требуется рабочий yacli MCP server и как минимум один авторизованный аккаунт Yandex

Предпосылки

• В OpenClaw уже должен быть настроен рабочий yacli MCP server
• Для используемых сервисов должен быть авторизован хотя бы один аккаунт Yandex
• Если yacli ещё не установлен или не интегрирован, ознакомьтесь с файлами references/install.md и references/mcporter-config.md
• Если отсутствуют необходимые tools или авторизация неполная, ознакомьтесь с файлом references/setup.md

Выбор аккаунта

• Если пользователь указал псевдоним (alias) или адрес электронной почты, используйте его
• В противном случае начните с yacli.account.current
• Если текущий аккаунт не задан, вызовите yacli.account.list
• Прежде чем делать вывод о неисправности авторизации, вызовите yacli.auth.status

Критичное правило именования tools

• Используйте только конкретные MCP tool id:
  • yacli.account.current
  • yacli.mail.list
  • yacli.disk.upload
  • yacli.calendar.events
• Не вызывайте абстрактные категории, такие как mail, disk, calendar, goal.route, или «голый» yacli
• Если вы вызываете tools через CLI mcporter, имена tools с точками необходимо передавать следующим образом:
  • mcporter call --server yacli --tool yacli.mail.list --args '{"folder":"INBOX"}'
• Не используйте синтаксис вида mcporter call yacli.mail.list ... для этого сервера, поскольку некоторые среды выполнения разбивают строку по первой точке и в результате пытаются вызвать неподдерживаемые tools, например mail

Почта

1. yacli.mail.folders
2. yacli.mail.list или yacli.mail.search
3. yacli.mail.read
4. Затем — только при необходимости:
   • yacli.mail.reply
   • yacli.mail.forward
   • yacli.mail.send

Вложения и приглашения

• yacli.mail.attachment.export — сохранить вложение на MCP host
• yacli.mail.invite.inspect — проанализировать календарное приглашение до выполнения действий с ним
• yacli.mail.invite.create_event — только после явного подтверждения пользователя

Disk

1. yacli.disk.info или yacli.disk.list
2. yacli.disk.mkdir — если требуется целевая директория
3. Затем один из вариантов:
   • yacli.disk.upload — для приватной загрузки
   • yacli.disk.upload_link — для загрузки с немедленной публичной ссылкой
   • yacli.disk.publish или yacli.disk.unpublish — для существующих файлов
   • yacli.disk.download — для экспорта приватного файла на MCP host
4. Используйте yacli.mail.send_link или yacli.mail.send_published_link, если пользователь хочет отправить общую ссылку на файл по электронной почте

Calendar

1. yacli.calendar.calendars
2. yacli.calendar.events
3. Затем — только при необходимости:
   • yacli.calendar.create
   • yacli.calendar.delete

• Для операций записи укажите явный идентификатор календаря (calendar id)
• Не предполагайте наличие «по умолчанию» (default calendar), если возможен предварительный запрос списка

Правила безопасности

• Не отправляйте электронные письма без явного подтверждения получателей и содержимого, за исключением случаев, когда пользователь прямо запросил отправку «сейчас»
• Не публикуйте приватные файлы и не создавайте публичные ссылки без явного подтверждения пользователя
• Не создавайте и не удаляйте события в Calendar без явного подтверждения пользователя
• Для разрушительных (destructive) или внешне видимых (externally visible) действий сначала выполните операцию чтения/списка (read/list), затем кратко опишите намеренную операцию, и только после этого её выполните