yjcho9317/nworks

Создает запись на доске объявлений. Используется для запросов вроде «напиши сообщение на доске», «создай уведомление» и т.п. boardId можно получить из nworks_board_list. Требуется аутентификация User OAuth (scope board).

Получает список досок объявлений NAVER WORKS. Используется для запросов вроде 'Какие есть доски объявлений?', 'Найди доску с объявлениями' и т.п. Требуется аутентификация User OAuth (область board.read).

Получает список записей на доске объявлений. Используется для запросов вида 'покажи записи доски', 'проверить объявления' и т.п. boardId можно получить через nworks_board_list. Требуется аутентификация пользователя OAuth (scope board.read).

Запрашивает детальное содержимое записи на доске объявлений. postId запрашивается через nworks_board_posts. Требуется OAuth-аутентификация пользователя (scope board.read).

Создаёт новое событие календаря. Используется при запросах вроде «назначь встречу», «зарегистрируй событие». Требуется User OAuth аутентификация (scope: calendar + calendar.read).

Удаляет календарное событие. Используется для запросов вида «Отмени событие». Требуется OAuth-аутентификация пользователя (scope: calendar + calendar.read). eventId получается через nworks_calendar_list.

Запрашивает расписание и события календаря пользователя. Используется для запросов вроде 'Расскажи о сегодняшних делах', 'Проверь расписание на эту неделю'. Требуется аутентификация OAuth пользователя (scope calendar.read). Если пользователь не авторизован, нужно войти через nworks_login_user.

Изменяет существующее событие календаря. Используется для запросов вроде «Измени время события», «Измени название встречи» и т.д. Требует аутентификации User OAuth (scopes: calendar + calendar.read). eventId можно получить через nworks_calendar_list.

Создаёт новый контакт. Используется для запросов вроде «добавь контакт». Payload передаёт JSON-объект, соответствующий спецификации NAVER WORKS API контактов, без изменений. contactName и permission обязательны, в permission.accessibleMembers должен быть как минимум 1 участник (обычно сам пользователь). Пример: {"contactName":{"lastName":"김","firstName":"철수"},"emails":[{"email":"a@b.com","primary":true}],"permission":{"accessibleRange":"MEMBER","isCoEditing":false,"accessibleMembers":[{"id":"<userId>","type":"USER"}]}}. Требуется аутентификация User OAuth (scope: contact).

Удаляет контакт. contactId можно получить из nworks_contact_list. Требуется OAuth-авторизация пользователя (contact scope).

Запрашивает подробную информацию о конкретном контакте. contactId можно получить через nworks_contact_list. Требуется аутентификация User OAuth (область contact.read).

NAVER WORKS запрашивает список личных контактов. Используется для запросов «Покажи список контактов», «Проверь мою визитницу». Требуется аутентификация User OAuth (область contact.read).

Запрашивает список тегов (групп) контактов. Используется для запросов типа «покажи список тегов контактов». Требуется аутентификация User OAuth (область contact.read).

Изменяет существующий контакт. contactId можно получить через nworks_contact_list. payload — это JSON-объект, содержащий только поля, которые нужно изменить. Требуется аутентификация пользователя через OAuth (область видимости contact).

Получает список членов организации (сотрудников) NAVER WORKS. Используется для запросов 'покажи список участников', 'найди коллегу', 'найти userId для отправки сообщения' и т.д. Использует аутентификацию Service Account (требуется nworks_setup). Запрашивает userId получателя для отправки сообщения. Если членов много, запрашивает следующие страницы с помощью nextCursor.

Диагностирует состояние подключения NAVER WORKS. Проверяет данные аутентификации, токены, Private Key, подключение API.

Загружает файл с Диска. Требуется аутентификация пользователя через OAuth (scope file.read). Если указан outputDir, сохраняет файл локально; если не указан, возвращает содержимое файла напрямую (текст — как text, бинарные — как base64). Для файлов размером более 5 МБ обязательно указывать outputDir.

Получает список файлов/папок диска NAVER WORKS. Используется для запросов вроде 'покажи файлы диска', 'мой список файлов'. Требуется аутентификация User OAuth (scope file.read).

Загружает файл на диск (требуется User OAuth file scope). Передаёт через content(base64) и fileName, или указывает локальный путь к файлу через filePath. Для MCP клиента рекомендует способ content+fileName.

Начинает вход пользователя через OAuth. Откройте возвращённый URL в браузере и войдите в NAVER WORKS. После завершения входа токен сохранится автоматически. Важно: не указывайте preset. Значение по умолчанию (default=all) включает все API (календарь, почту, задачи, диск, доску объявлений), поэтому после одного входа вы сможете пользоваться всеми функциями. Чтобы ограничить доступ только чтением, укажите preset='readonly' (в этом случае для инструментов создания/изменения/удаления потребуется повторный вход).

Удаляет все сохранённые учётные данные и токены NAVER WORKS.

Загружает вложение из письма. mailId и attachmentId можно получить через nworks_mail_read. Требуется аутентификация User OAuth (scope: mail.read). Если указать outputDir, сохраняет файл локально; если не указать, возвращает содержимое файла напрямую (текст — text, бинарные данные — base64). Для файлов размером более 5 МБ обязательно указывать outputDir.

Получает список входящих писем. Используется для запросов вроде «Проверь почту», «Покажи входящие», «Есть непрочитанные письма?». Требуется аутентификация User OAuth (scope mail.read).

Получает подробное содержимое (тело, вложения и т.д.) конкретного письма. Используется для запросов типа «покажи содержимое этого письма». mailId можно получить через nworks_mail_list. Требуется аутентификация User OAuth (область mail.read).

Отправляет почту NAVER WORKS. Используется для запросов типа 'отправь письмо', 'напиши email'. Асинхронная отправка (при успехе 202). Требуется аутентификация пользователя через OAuth (mail scope).

Запрашивает список участников определённого канала. Используется для запросов типа «Кто есть на этом канале?». Использует аутентификацию через Service Account (требуется nworks_setup).

Отправляет сообщения NAVER WORKS (бот отправляет пользователю или в канал). Использует аутентификацию Service Account (в nworks_setup настраиваются serviceAccount, botId + требуется переменная окружения NWORKS_PRIVATE_KEY_PATH. User OAuth не требуется).

NAVER WORKS API 인증 정보를 설정합니다. Устанавливает параметры аутентификации API NAVER WORKS. ■ 사전 준비 (사용자가 직접 해야 함): 1. https://dev.worksmobile.com 에서 앱 생성 후 Client ID와 Client Secret을 발급받습니다. 2. MCP 설정 파일(예: claude_desktop_config.json)의 nworks 서버에 env 필드를 추가합니다: { "env": { "NWORKS_CLIENT_SECRET": "<발급받은 Client Secret>" } } 3. MCP 클라이언트(예: Claude Desktop)를 재시작합니다. ■ Предварительные шаги (пользователь выполняет самостоятельно): 1. Создайте приложение на https://dev.worksmobile.com и получите Client ID и Client Secret. 2. В файле настроек MCP (например, claude_desktop_config.json) добавьте поле env в сервер nworks: { "env": { "NWORKS_CLIENT_SECRET": "<полученный Client Secret>" } } 3. Перезапустите MCP клиент (например, Claude Desktop). ■ 이 tool의 역할: - clientId(필수)와 serviceAccount, botId, domainId(선택)를 파라미터로 받아 저장합니다. - Client Secret은 보안을 위해 파라미터로 받지 않으며, 환경변수 NWORKS_CLIENT_SECRET에서 자동으로 읽습니다. - Service Account 사용 시 환경변수 NWORKS_PRIVATE_KEY_PATH도 필요합니다. ■ Назначение этого инструмента: - Принимает и сохраняет clientId (обязательно), а также serviceAccount, botId, domainId (опционально) в качестве параметров. - Client Secret не принимается в качестве параметра из соображений безопасности — он автоматически читается из переменной окружения NWORKS_CLIENT_SECRET. - При использовании Service Account также требуется переменная окружения NWORKS_PRIVATE_KEY_PATH. ■ 설정 후 다음 단계: - 캘린더/메일/드라이브/할일/게시판 → nworks_login_user tool로 브라우저 로그인 필요 - 메시지/구성원조회 → Service Account 인증 (serviceAccount + botId + NWORKS_PRIVATE_KEY_PATH) ■ Дальнейшие шаги после настройки: - Для календаря/почты/диска/задач/доски объявлений: требуется вход через браузер с помощью инструмента nworks_login_user. - Для сообщений/поиска участников: аутентификация через Service Account (serviceAccount + botId + NWORKS_PRIVATE_KEY_PATH). ■ 환경변수 NWORKS_CLIENT_SECRET이 없으면 이 tool은 실패합니다. 실패 시 사용자에게 위 사전 준비 단계를 안내하세요. ■ Если переменная окружения NWORKS_CLIENT_SECRET отсутствует, этот инструмент завершится ошибкой. В случае ошибки сообщите пользователю о предварительных шагах, описанных выше. OAuth Redirect URI: http://localhost:9876/callback

Скачивает файл из общего диска. Требуется аутентификация User OAuth (область file.read). Если указан outputDir, сохраняет файл локально; если не указан — возвращает содержимое файла напрямую (текст — как text, бинарные данные — как base64). Файлы размером более 5 МБ необходимо обязательно указывать outputDir.

Получает список файлов и папок общего диска. sharedriveId можно получить через nworks_sharedrive_list. Требуется аутентификация User OAuth (область file.read).

Получает список общих дисков NAVER WORKS. Используется для запросов вроде «Какие есть общие диски?», «Найди командный общий диск» и т.п. Требуется аутентификация User OAuth (область file.read).

Создаёт новую задачу (TODO). Используется для запросов вроде 'Добавь задачу', 'Зарегистрируй TODO' и т.п. По умолчанию назначается самому себе. Требуется аутентификация User OAuth (scope: task + user.read).

Удаляет задачу. taskId можно запросить через nworks_task_list. Требуется аутентификация User OAuth (скоупы task + user.read).

Запрашивает список дел (TODO). Используется для запросов вроде 'проверь список дел', 'покажи TODO-список', 'какие задачи остались?'. Требуется авторизация OAuth пользователя (scope task.read).

Редактирует или завершает задачу. Используется для запросов типа «Отметь задачу как выполненную», «Измени дедлайн» и т.п. taskId можно узнать через nworks_task_list. Требуется аутентификация User OAuth (области task + user.read).

Проверяет информацию о текущей аутентифицированной учетной записи NAVER WORKS и статусе действительности токена. Вызывается первым при диагностике проблем аутентификации.