teams CLI
teams-cli
CLI на Rust для Microsoft Teams: сообщения, каналы и события через Graph API с ответом в JSON и кодами выхода, понятными агенту.
- 61 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент публикует сообщения от имени вошедшего пользователя и управляет командами и каналами через Graph с делегированными правами.
Установка
- Работает в
Ручная установка
brew install osodevops/tap/teams-cliПервая команда установки из раздела Install README; скиллы ставятся отдельно через `npx skills add osodevops/ms-teams-cli`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент публикует сообщения от имени вошедшего пользователя и управляет командами и каналами через Graph с делегированными правами.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Один бинарный файл `teams` дает агенту и скриптам доступ к Microsoft Teams через Microsoft Graph API. Каждая команда при вызове из конвейера возвращает JSON-конверт с полями `success`, `data` и `metadata`, а при ошибке код вроде `AUTH_TOKEN_EXPIRED`. Коды выхода сведены в таблицу: 3 для ошибки входа, 4 для отказа в правах, 6 для лимита запросов, 7 для сети. Агент разбирает их без чтения текста. Вместе с CLI идут скиллы `teams-cli-setup`, `teams-cli-messaging`, `teams-cli-admin` и `teams-cli-automation` с правилами входа, переписки, управления командами и автоматизации.
Для кого. Администраторам и разработчикам, которые автоматизируют рабочие процессы в Microsoft Teams агентом или скриптом без собственного бота.
Подходит, если
- Агент должен прочитать чат и опубликовать итог в канале от имени пользователя.
- Конвейер CI пишет в Teams о результатах сборки и ждет понятный код выхода.
- Администратору нужно списком создать команды и каналы из скрипта.
- Для арендатора клиента нужна отдельная учетная запись и приложение: профили `--profile` держат их раздельно.
Не подходит, если
- Нужен разговорный бот внутри Teams: инструмент вызывается извне и бота не заменяет.
- Организация запрещает делегированные права Graph или не выдает согласие администратора.
- Требуется токен, снятый из веб-клиента Teams: Graph принимает только собственные токены.
Пример запроса к агенту
Прочитай последние сообщения в канале Engineering командой teams и опубликуй там итог дня одним сообщением.Ограничения
Для сообщений и действий от лица пользователя нужен вход с делегированными правами: `teams auth login` или `teams auth login --device-code`. Чтение сообщений каналов требует более широкой области `ChannelMessage.Read.All`, и часто нужно согласие администратора. Токены, снятые из веб-клиента Teams, не подходят: у них не тот адресат. Приложение клиента используют через `--client-id` и `--tenant-id`. Права запрашиваются на уровне аккаунта, поэтому агент публикует сообщения от имени вошедшего человека.
Как отключить. Выйдите командой `teams auth` для своего профиля, удалите бинарный файл (`brew uninstall teams-cli`, `scoop uninstall teams` или `cargo uninstall`) и снимите согласие приложения в Microsoft Entra.
Частые вопросы
Как установить teams?
`brew install osodevops/tap/teams-cli` на macOS и Linux, `scoop install teams` на Windows либо `cargo install --git https://github.com/osodevops/ms-teams-cli`.
Как поставить скиллы для агента?
Командой `npx skills add osodevops/ms-teams-cli`. Один скилл ставится флагом `--skill`, например `--skill teams-cli-messaging`.
Как войти, если нет браузера?
Используйте `teams auth login --device-code`: CLI покажет код и адрес для подтверждения на другом устройстве.
Как проверить вход и права?
`teams auth doctor --output json` показывает состояние входа, арендатора, тип токена и адрес согласия.
Какие коды выхода у команд?
0 успех, 2 неверные аргументы, 3 ошибка входа, 4 отказ в правах, 5 не найдено, 6 лимит запросов, 7 сеть, 8 ошибка сервера, 10 ошибка настройки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и скилл для Slack: агент читает каналы и треды, ищет сообщения и файлы, а черновики и отправку выполняет только по вашему запросу
CLI и скилл для Яндекс Трекера и Вики: короткий человеко- и агенто-читаемый вывод вместо сырых ответов MCP на тысячи токенов
Linear CLI
linear-cli
CLI для Linear в терминале: список, запуск и создание задач, PR из ветки, вывод в JSON и скилл для агентов, с поддержкой git и jj
MCP Teams Server
mcp-teams-server
Сервер MCP для Microsoft Teams: чтение сообщений канала, создание тредов с упоминаниями и ответы. Код открыт компанией Inditex, запускается в Docker
WeCom CLI
wecom-cli
Официальный CLI WeCom и 15 навыков для агентов: сообщения, документы, календарь, встречи, почта и диск из терминала
MCP-сервер превращает запрос обычными словами в цепочку команд CLI for Microsoft 365: SharePoint, Teams, Planner, Power Platform.
Коротко о README
В README есть контракт для агентов: единый JSON-конверт, таблица кодов выхода и правила обработки обрезанных списков. Входу посвящен отдельный раздел с вариантами для своего приложения.