Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NWORKS_SCOPE | No | Optional. Space-separated list of scopes. Defaults to 'bot bot.read user.read'. | |
| NWORKS_BOT_ID | No | The ID of the bot. Required specifically for bot messaging functionality. | |
| NWORKS_VERBOSE | No | Optional. Set to '1' to enable verbose debug logging. | |
| NWORKS_CLIENT_ID | Yes | NAVER WORKS API Client ID. Required for API authentication. | |
| NWORKS_DOMAIN_ID | No | Optional domain ID for the NAVER WORKS environment. | |
| NWORKS_CLIENT_SECRET | Yes | NAVER WORKS API Client Secret. Required for API authentication. | |
| NWORKS_SERVICE_ACCOUNT | No | The Service Account ID. Required specifically for bot messaging functionality. | |
| NWORKS_PRIVATE_KEY_PATH | No | The file path to the private key. Required specifically for bot messaging functionality. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nworks_setup | NAVER WORKS API 인증 정보를 설정합니다. clientId는 필수, clientSecret은 환경변수(NWORKS_CLIENT_SECRET)로도 설정 가능합니다. 민감 정보는 환경변수로 설정하는 것을 권장합니다 (NWORKS_CLIENT_ID, NWORKS_CLIENT_SECRET 등). 메시지/구성원조회는 Service Account 인증(serviceAccount, privateKeyPath, botId 추가 필요). 캘린더/메일/할일/드라이브/게시판은 User OAuth 인증(설정 후 nworks_login_user로 브라우저 로그인 필요). OAuth Redirect URI: http://localhost:9876/callback |
| nworks_message_send | NAVER WORKS 메시지를 전송합니다 (봇이 사용자 또는 채널에 발송). Service Account 인증 사용 (nworks_setup에서 serviceAccount, privateKeyPath, botId 설정 필요. User OAuth 불필요) |
| nworks_message_members | 특정 채널의 구성원 목록을 조회합니다. '이 채널에 누가 있어?' 등의 요청에 사용. Service Account 인증 사용 (nworks_setup 필요) |
| nworks_directory_members | NAVER WORKS 조직 구성원(직원) 목록을 조회합니다. '구성원 목록 보여줘', '팀원 찾아줘', '누구한테 메시지 보낼지 userId 찾기' 등에 사용. Service Account 인증 사용 (nworks_setup 필요). 메시지 전송 시 수신자 userId를 여기서 조회 가능 |
| nworks_calendar_list | 사용자의 캘린더 일정/스케줄을 조회합니다. '오늘 일정 알려줘', '이번 주 스케줄 확인' 등의 요청에 사용. User OAuth 인증 필요 (calendar.read scope). 미로그인 시 nworks_login_user로 로그인 필요 |
| nworks_calendar_create | 캘린더 일정을 새로 만듭니다. '회의 잡아줘', '일정 등록해줘' 등의 요청에 사용. User OAuth 인증 필요 (calendar + calendar.read scope) |
| nworks_calendar_update | 기존 캘린더 일정을 수정합니다. '일정 시간 변경해줘', '회의 제목 바꿔줘' 등의 요청에 사용. User OAuth 인증 필요 (calendar + calendar.read scope). eventId는 nworks_calendar_list로 조회 가능 |
| nworks_calendar_delete | 캘린더 일정을 삭제합니다. '일정 취소해줘' 등의 요청에 사용. User OAuth 인증 필요 (calendar + calendar.read scope). eventId는 nworks_calendar_list로 조회 가능 |
| nworks_drive_list | NAVER WORKS 드라이브의 파일/폴더 목록을 조회합니다. '드라이브 파일 보여줘', '내 파일 목록' 등의 요청에 사용. User OAuth 인증 필요 (file.read scope) |
| nworks_drive_upload | 파일을 드라이브에 업로드합니다 (User OAuth file scope 필요). content(base64)와 fileName으로 전달하거나, filePath로 로컬 파일 경로를 지정합니다. MCP 클라이언트에서는 content+fileName 방식을 권장합니다. |
| nworks_drive_download | 드라이브 파일을 다운로드합니다. User OAuth 인증 필요 (file.read scope). outputDir을 지정하면 로컬에 파일로 저장하고, 미지정 시 파일 내용을 직접 반환합니다 (텍스트는 text, 바이너리는 base64). 5MB 초과 파일은 반드시 outputDir를 지정해야 합니다. |
| nworks_mail_send | NAVER WORKS 메일을 전송합니다. '메일 보내줘', '이메일 작성해줘' 등의 요청에 사용. 비동기 전송(성공 시 202). User OAuth 인증 필요 (mail scope) |
| nworks_mail_list | 받은 메일 목록을 조회합니다. '메일 확인해줘', '받은편지함 보여줘', '안 읽은 메일 있어?' 등의 요청에 사용. User OAuth 인증 필요 (mail.read scope) |
| nworks_mail_read | 특정 메일의 상세 내용(본문, 첨부파일 등)을 조회합니다. '이 메일 내용 보여줘' 등의 요청에 사용. mailId는 nworks_mail_list로 조회 가능. User OAuth 인증 필요 (mail.read scope) |
| nworks_task_list | 할 일(TODO) 목록을 조회합니다. '할 일 확인해줘', 'TODO 목록 보여줘', '남은 업무 뭐 있어?' 등의 요청에 사용. User OAuth 인증 필요 (task.read scope) |
| nworks_task_create | 할 일(TODO)을 새로 만듭니다. '할 일 추가해줘', 'TODO 등록해줘' 등의 요청에 사용. 기본적으로 자기 자신에게 할당. User OAuth 인증 필요 (task + user.read scope) |
| nworks_task_update | 할 일을 수정하거나 완료 처리합니다. '할 일 완료 처리해줘', '마감일 변경해줘' 등의 요청에 사용. taskId는 nworks_task_list로 조회 가능. User OAuth 인증 필요 (task + user.read scope) |
| nworks_task_delete | 할 일을 삭제합니다. taskId는 nworks_task_list로 조회 가능. User OAuth 인증 필요 (task + user.read scope) |
| nworks_board_list | NAVER WORKS 게시판 목록을 조회합니다. '게시판 뭐 있어?', '공지사항 게시판 찾아줘' 등의 요청에 사용. User OAuth 인증 필요 (board.read scope) |
| nworks_board_posts | 게시판의 글 목록을 조회합니다. '게시판 글 보여줘', '공지사항 확인' 등의 요청에 사용. boardId는 nworks_board_list로 조회 가능. User OAuth 인증 필요 (board.read scope) |
| nworks_board_read | 게시판 글의 상세 내용을 조회합니다. postId는 nworks_board_posts로 조회 가능. User OAuth 인증 필요 (board.read scope) |
| nworks_board_create | 게시판에 글을 작성합니다. '게시판에 글 올려줘', '공지 작성해줘' 등의 요청에 사용. boardId는 nworks_board_list로 조회 가능. User OAuth 인증 필요 (board scope) |
| nworks_login_user | User OAuth 로그인을 시작합니다. 반환된 URL을 브라우저에서 열어 NAVER WORKS에 로그인하세요. 로그인 완료 후 자동으로 토큰이 저장됩니다. 중요: scope를 지정하지 마세요. 기본값이 모든 API(캘린더, 메일, 할일, 드라이브, 게시판)를 포함하므로 한 번 로그인으로 전체 기능을 사용할 수 있습니다. scope를 좁게 지정하면 다른 기능 사용 시 재로그인이 필요합니다. |
| nworks_whoami | 현재 인증된 NAVER WORKS 계정 정보와 토큰 유효 상태를 확인합니다. 인증 문제 진단 시 먼저 호출 |
| nworks_logout | 저장된 NAVER WORKS 인증 정보와 토큰을 모두 삭제합니다 |
| nworks_doctor | NAVER WORKS 연결 상태를 진단합니다. 인증 정보, 토큰, Private Key, API 연결을 점검합니다. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |