yandex-office

Install

git clone https://github.com/bizyumov/yandex-office.git

This is third-party code. Review the repository files before installing.

What it does

Eight sub-skills with Python scripts give the agent access to Yandex office services. Mail fetches and sends via IMAP and SMTP with XOAUTH2, Calendar and Contacts use CalDAV and CardDAV, and Directory uses the Yandex 360 API. Disk lists, uploads, downloads, imports by URL and manages public links, Telemost processes meeting transcript emails, Forms exports responses and Tracker manages issues and boards. Auth uses OAuth with the minimum required app and tokens stored outside the repo.

Who it is for. For teams and managers on Yandex 360 who want an agent to handle mail, meetings and tasks.

Example request

Fetch today's daily stand-up transcript from Telemost mail and make a task list

Limitations

Requires Python 3.10+, per-skill dependencies and OAuth tokens per service. The office-core app covers Mail, Disk, Calendar and Telemost; Contacts, Tracker, Forms and Directory need separate apps. Direct large uploads to Disk are slow, so there is an optional boto3 S3 bridge.

How to disable. Remove the yandex-office folder from the skills directory. Delete tokens with oauth_setup.py --accounts delete --account <alias> or revoke them in Yandex ID settings.

Security check

• Gets OAuth access to account mail, disk, calendar and tasks
• Can send emails and publish files
• Runs Python scripts that call Yandex APIs

README in short

yandex-office follows the agentskills.io spec with dated versions. The README covers the sub-skills, shared two-level config, mail filters, OAuth routing via screen codes and the data directory layout. The latest release expanded Disk support: private paths, public folders, URL import and large uploads via S3. Yandex Search and Yandex Cloud moved to separate repositories. A regression test suite is included.

SKILL.md

---
name: yandex-office
description: Shared Yandex skill pack for Mail, Disk, Telemost, Calendar, Contacts, Directory, Forms, and Tracker. Yandex Search and Yandex Cloud live in separate standalone skill repos.
homepage: https://github.com/bizyumov/yandex-office
license: MIT
compatibility: Python 3.10+, per-skill dependencies, network access for Yandex APIs
metadata:
  author: bizyumov
  version: "2026.08.31"
---

# yandex-office

## Command shorthand

Set once in the shell before running the examples in this document:

```bash
YO="python3 <full-path-to-yandex-office>"
```

Replace the placeholder with the absolute skill path. Commands below reuse `$YO`;
they do not change the working directory or runtime data-directory resolution.

## Account-First Workflow

Run first:
`$YO/scripts/oauth_setup.py --accounts list`

If aliases print, choose only an exact listed alias. If no alias is suitable,
pause the business task and set up or import the account through `yandex-office`
under user authorization.

Then choose the sub-skill:
- Mail: `mail/mail.md`
- Calendar: `calendars/calendar.md`
- Telemost: `telemost/telemost.md`
- Disk: `disk/disk.md`
- Contacts: `contacts/contacts.md`
- Directory: `directory/directory.md`
- Forms: `forms/forms.md`
- Tracker: `tracker/tracker.md`

## OAuth App Selector

Use the default/read app unless the user requests a write-capable operation or
explicitly approves broader access.

- Mail read/fetch: default `mail-readonly`; IMAP mutation/delete: `mail-readwrite`; SMTP send: `mail-smtp`.
- Disk read/download: default `disk-read`; app-folder-only: `disk-app`; write-capable `disk-full`.
- Tracker read/search: default `tracker-read`; write-capable `tracker-full`.

Related