NAVER WORKS API 인증 정보를 설정합니다.

■ 사전 준비 (사용자가 직접 해야 함):

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)를 재시작합니다.

■ 이 tool의 역할:

• 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_CLIENT_SECRET이 없으면 이 tool은 실패합니다. 실패 시 사용자에게 위 사전 준비 단계를 안내하세요.

OAuth Redirect URI: http://localhost:9876/callback

NAVER WORKS 메시지를 전송합니다 (봇이 사용자 또는 채널에 발송). Service Account 인증 사용 (nworks_setup에서 serviceAccount, botId 설정 + 환경변수 NWORKS_PRIVATE_KEY_PATH 필요. User OAuth 불필요)

특정 채널의 구성원 목록을 조회합니다. '이 채널에 누가 있어?' 등의 요청에 사용. Service Account 인증 사용 (nworks_setup 필요)

NAVER WORKS 조직 구성원(직원) 목록을 조회합니다. '구성원 목록 보여줘', '팀원 찾아줘', '누구한테 메시지 보낼지 userId 찾기' 등에 사용. Service Account 인증 사용 (nworks_setup 필요). 메시지 전송 시 수신자 userId를 여기서 조회 가능. 구성원이 많으면 nextCursor로 다음 페이지를 이어서 조회

사용자의 캘린더 일정/스케줄을 조회합니다. '오늘 일정 알려줘', '이번 주 스케줄 확인' 등의 요청에 사용. User OAuth 인증 필요 (calendar.read scope). 미로그인 시 nworks_login_user로 로그인 필요

캘린더 일정을 새로 만듭니다. '회의 잡아줘', '일정 등록해줘' 등의 요청에 사용. User OAuth 인증 필요 (calendar + calendar.read scope)

기존 캘린더 일정을 수정합니다. '일정 시간 변경해줘', '회의 제목 바꿔줘' 등의 요청에 사용. User OAuth 인증 필요 (calendar + calendar.read scope). eventId는 nworks_calendar_list로 조회 가능

캘린더 일정을 삭제합니다. '일정 취소해줘' 등의 요청에 사용. User OAuth 인증 필요 (calendar + calendar.read scope). eventId는 nworks_calendar_list로 조회 가능

NAVER WORKS 드라이브의 파일/폴더 목록을 조회합니다. '드라이브 파일 보여줘', '내 파일 목록' 등의 요청에 사용. User OAuth 인증 필요 (file.read scope)

파일을 드라이브에 업로드합니다 (User OAuth file scope 필요). content(base64)와 fileName으로 전달하거나, filePath로 로컬 파일 경로를 지정합니다. MCP 클라이언트에서는 content+fileName 방식을 권장합니다.

드라이브 파일을 다운로드합니다. User OAuth 인증 필요 (file.read scope). outputDir을 지정하면 로컬에 파일로 저장하고, 미지정 시 파일 내용을 직접 반환합니다 (텍스트는 text, 바이너리는 base64). 5MB 초과 파일은 반드시 outputDir를 지정해야 합니다.

NAVER WORKS 공유 드라이브 목록을 조회합니다. '공유 드라이브 뭐 있어?', '팀 공유 드라이브 찾아줘' 등의 요청에 사용. User OAuth 인증 필요 (file.read scope)

공유 드라이브의 파일/폴더 목록을 조회합니다. sharedriveId는 nworks_sharedrive_list로 조회 가능. User OAuth 인증 필요 (file.read scope)

공유 드라이브 파일을 다운로드합니다. User OAuth 인증 필요 (file.read scope). outputDir을 지정하면 로컬에 파일로 저장하고, 미지정 시 파일 내용을 직접 반환합니다 (텍스트는 text, 바이너리는 base64). 5MB 초과 파일은 반드시 outputDir를 지정해야 합니다.

NAVER WORKS 메일을 전송합니다. '메일 보내줘', '이메일 작성해줘' 등의 요청에 사용. 비동기 전송(성공 시 202). User OAuth 인증 필요 (mail scope)

받은 메일 목록을 조회합니다. '메일 확인해줘', '받은편지함 보여줘', '안 읽은 메일 있어?' 등의 요청에 사용. User OAuth 인증 필요 (mail.read scope)

특정 메일의 상세 내용(본문, 첨부파일 등)을 조회합니다. '이 메일 내용 보여줘' 등의 요청에 사용. mailId는 nworks_mail_list로 조회 가능. User OAuth 인증 필요 (mail.read scope)

메일 첨부파일을 다운로드합니다. mailId와 attachmentId는 nworks_mail_read로 조회 가능. User OAuth 인증 필요 (mail.read scope). outputDir을 지정하면 로컬에 파일로 저장하고, 미지정 시 파일 내용을 직접 반환합니다 (텍스트는 text, 바이너리는 base64). 5MB 초과 파일은 반드시 outputDir를 지정해야 합니다.

할 일(TODO) 목록을 조회합니다. '할 일 확인해줘', 'TODO 목록 보여줘', '남은 업무 뭐 있어?' 등의 요청에 사용. User OAuth 인증 필요 (task.read scope)

할 일(TODO)을 새로 만듭니다. '할 일 추가해줘', 'TODO 등록해줘' 등의 요청에 사용. 기본적으로 자기 자신에게 할당. User OAuth 인증 필요 (task + user.read scope)

할 일을 수정하거나 완료 처리합니다. '할 일 완료 처리해줘', '마감일 변경해줘' 등의 요청에 사용. taskId는 nworks_task_list로 조회 가능. User OAuth 인증 필요 (task + user.read scope)

할 일을 삭제합니다. taskId는 nworks_task_list로 조회 가능. User OAuth 인증 필요 (task + user.read scope)

NAVER WORKS 게시판 목록을 조회합니다. '게시판 뭐 있어?', '공지사항 게시판 찾아줘' 등의 요청에 사용. User OAuth 인증 필요 (board.read scope)

게시판의 글 목록을 조회합니다. '게시판 글 보여줘', '공지사항 확인' 등의 요청에 사용. boardId는 nworks_board_list로 조회 가능. User OAuth 인증 필요 (board.read scope)

게시판 글의 상세 내용을 조회합니다. postId는 nworks_board_posts로 조회 가능. User OAuth 인증 필요 (board.read scope)

게시판에 글을 작성합니다. '게시판에 글 올려줘', '공지 작성해줘' 등의 요청에 사용. boardId는 nworks_board_list로 조회 가능. User OAuth 인증 필요 (board scope)

NAVER WORKS 개인 연락처 목록을 조회합니다. '연락처 목록 보여줘', '내 명함첩 확인' 등의 요청에 사용. User OAuth 인증 필요 (contact.read scope)

특정 연락처의 상세 정보를 조회합니다. contactId는 nworks_contact_list로 조회 가능. User OAuth 인증 필요 (contact.read scope)

새 연락처를 만듭니다. '연락처 추가해줘' 등의 요청에 사용. payload는 NAVER WORKS 연락처 API 스펙에 맞는 JSON 객체를 그대로 전달합니다. contactName과 permission은 필수이며, permission.accessibleMembers에는 최소 1명이 있어야 합니다(보통 본인). 예: {"contactName":{"lastName":"김","firstName":"철수"},"emails":[{"email":"a@b.com","primary":true}],"permission":{"accessibleRange":"MEMBER","isCoEditing":false,"accessibleMembers":[{"id":"","type":"USER"}]}}. User OAuth 인증 필요 (contact scope)

기존 연락처를 수정합니다. contactId는 nworks_contact_list로 조회 가능. payload는 수정할 필드만 담은 JSON 객체입니다. User OAuth 인증 필요 (contact scope)

연락처를 삭제합니다. contactId는 nworks_contact_list로 조회 가능. User OAuth 인증 필요 (contact scope)

연락처 태그(그룹) 목록을 조회합니다. '연락처 태그 목록 보여줘' 등의 요청에 사용. User OAuth 인증 필요 (contact.read scope)

User OAuth 로그인을 시작합니다. 반환된 URL을 브라우저에서 열어 NAVER WORKS에 로그인하세요. 로그인 완료 후 자동으로 토큰이 저장됩니다. 중요: preset을 지정하지 마세요. 기본값(default=all)이 모든 API(캘린더, 메일, 할일, 드라이브, 게시판)를 포함하므로 한 번 로그인으로 전체 기능을 사용할 수 있습니다. 읽기 전용으로 제한하려면 preset='readonly'를 지정하세요(이 경우 생성/수정/삭제 도구는 재로그인 필요).

현재 인증된 NAVER WORKS 계정 정보와 토큰 유효 상태를 확인합니다. 인증 문제 진단 시 먼저 호출

저장된 NAVER WORKS 인증 정보와 토큰을 모두 삭제합니다

NAVER WORKS 연결 상태를 진단합니다. 인증 정보, 토큰, Private Key, API 연결을 점검합니다.