nworks-plus 1.3.0 → 1.4.0

package/README.ja.md

@@ -1,8 +1,8 @@
-# nworks
+# nworks-plus
 
-[![npm version](https://img.shields.io/npm/v/nworks.svg)](https://www.npmjs.com/package/nworks)
-[![license](https://img.shields.io/npm/l/nworks.svg)](LICENSE)
-[![npm downloads](https://img.shields.io/npm/dm/nworks.svg)](https://www.npmjs.com/package/nworks)
+[![npm version](https://img.shields.io/npm/v/nworks-plus.svg)](https://www.npmjs.com/package/nworks-plus)
+[![license](https://img.shields.io/npm/l/nworks-plus.svg)](LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/nworks-plus.svg)](https://www.npmjs.com/package/nworks-plus)
 [![nworks MCP server](https://glama.ai/mcp/servers/yjcho9317/nworks/badges/score.svg)](https://glama.ai/mcp/servers/yjcho9317/nworks)
 
 Featured in [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)
@@ -19,7 +19,7 @@ LINE WORKS (NAVER WORKS) 初のMCPサーバー。
 ## クイックスタート
 
 ```bash
-npm install -g nworks
+npm install -g nworks-plus
 nworks login --user
 nworks calendar list
 ```
@@ -49,8 +49,8 @@ Claude → nworks_mail_read (各)
 ## インストール
 
 ```bash
-npx nworks             # 直接実行
-npm install -g nworks  # グローバルインストール
+npx nworks-plus             # 直接実行
+npm install -g nworks-plus  # グローバルインストール
 ```
 
 ## ログイン
@@ -376,7 +376,7 @@ NWORKS_VERBOSE=1           # デバッグログ
   "mcpServers": {
     "nworks": {
       "command": "npx",
-      "args": ["-y", "nworks", "mcp"],
+      "args": ["-y", "nworks-plus", "mcp"],
       "env": {
         "NWORKS_CLIENT_SECRET": "<Client Secret>",
         "NWORKS_PRIVATE_KEY_PATH": "<Private Keyファイルの絶対パス（Service Account使用時）>"

package/README.ko.md

@@ -1,8 +1,8 @@
-# nworks
+# nworks-plus
 
-[![npm version](https://img.shields.io/npm/v/nworks.svg)](https://www.npmjs.com/package/nworks)
-[![license](https://img.shields.io/npm/l/nworks.svg)](LICENSE)
-[![npm downloads](https://img.shields.io/npm/dm/nworks.svg)](https://www.npmjs.com/package/nworks)
+[![npm version](https://img.shields.io/npm/v/nworks-plus.svg)](https://www.npmjs.com/package/nworks-plus)
+[![license](https://img.shields.io/npm/l/nworks-plus.svg)](LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/nworks-plus.svg)](https://www.npmjs.com/package/nworks-plus)
 [![nworks MCP server](https://glama.ai/mcp/servers/yjcho9317/nworks/badges/score.svg)](https://glama.ai/mcp/servers/yjcho9317/nworks)
 
 Featured in [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)
@@ -14,12 +14,12 @@ Featured in [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-server
 </p>
 
 NAVER WORKS (LINE WORKS) 최초의 MCP 서버.
-메시지, 캘린더, 드라이브, 메일, 할 일, 게시판 — 28개 도구를 CLI와 AI 에이전트에서 쓸 수 있습니다.
+메시지, 캘린더, 드라이브, 메일, 할 일, 게시판 — 31개 도구를 CLI와 AI 에이전트에서 쓸 수 있습니다.
 
 ## Quickstart
 
 ```bash
-npm install -g nworks
+npm install -g nworks-plus
 nworks login --user
 nworks calendar list
 ```
@@ -49,8 +49,8 @@ Claude → nworks_mail_read (각각)
 ## Install
 
 ```bash
-npx nworks             # 바로 실행
-npm install -g nworks  # 글로벌 설치
+npx nworks-plus             # 바로 실행
+npm install -g nworks-plus  # 글로벌 설치
 ```
 
 ## 로그인
@@ -104,7 +104,7 @@ nworks login --user --scope "calendar calendar.read file file.read mail mail.rea
 
 > **MCP에서 AI 에이전트가 직접 설정하기**: CLI 로그인 없이도 AI 에이전트가 `nworks_setup` → `nworks_login_user` 순서로 호출하면 브라우저 로그인만으로 전체 기능을 사용할 수 있습니다. Client Secret과 Private Key 경로는 MCP 설정의 `env` 필드 또는 시스템 환경변수로 미리 설정해야 합니다.
 
-### MCP 도구 목록 (28개)
+### MCP 도구 목록 (31개)
 
 | 도구 | 설명 | 필요 인증 |
 |------|------|----------|
@@ -128,6 +128,9 @@ nworks login --user --scope "calendar calendar.read file file.read mail mail.rea
 | `nworks_drive_list` | 드라이브 파일/폴더 목록 | User OAuth (file.read) |
 | `nworks_drive_upload` | 드라이브 파일 업로드 | User OAuth (file) |
 | `nworks_drive_download` | 드라이브 파일 다운로드 (5MB 초과 시 로컬 저장) | User OAuth (file.read) |
+| `nworks_drive_sharedrive_list` | 팀 공유 드라이브 목록 | User OAuth (file.read) |
+| `nworks_drive_sharedrive_files` | 공유 드라이브 내 파일 목록 | User OAuth (file.read) |
+| `nworks_drive_sharedrive_download` | 공유 드라이브 파일 다운로드 | User OAuth (file.read) |
 | **메일** | | |
 | `nworks_mail_send` | 메일 전송 | User OAuth (mail) |
 | `nworks_mail_list` | 메일 목록 조회 | User OAuth (mail.read) |
@@ -248,6 +251,17 @@ nworks drive download --file-id <fileId>
 
 # 다운로드 경로/파일명 지정
 nworks drive download --file-id <fileId> --out ./downloads --name report.pdf
+
+# ── 공유 드라이브 (개인 "내 드라이브"와 별개인 팀 공유 저장소) ──
+# 공유 드라이브 목록 (sharedriveId 확인)
+nworks drive sharedrive-list
+
+# 공유 드라이브 파일 목록 (루트 → 폴더 진입)
+nworks drive sharedrive-files --drive <sharedriveId>
+nworks drive sharedrive-files --drive <sharedriveId> --folder <fileId>
+
+# 공유 드라이브 파일 다운로드
+nworks drive sharedrive-download --drive <sharedriveId> --file-id <fileId> --out ./downloads
 ```
 
 ### 메일 (User OAuth)
@@ -399,7 +413,7 @@ NWORKS_VERBOSE=1           # 디버그 로깅
   "mcpServers": {
     "nworks": {
       "command": "npx",
-      "args": ["-y", "nworks", "mcp"],
+      "args": ["-y", "nworks-plus", "mcp"],
       "env": {
         "NWORKS_CLIENT_SECRET": "<Client Secret>",
         "NWORKS_PRIVATE_KEY_PATH": "<Private Key 파일 절대 경로 (Service Account 사용 시)>"

package/README.md

@@ -1,8 +1,8 @@
-# nworks
+# nworks-plus
 
-[![npm version](https://img.shields.io/npm/v/nworks.svg)](https://www.npmjs.com/package/nworks)
-[![license](https://img.shields.io/npm/l/nworks.svg)](LICENSE)
-[![npm downloads](https://img.shields.io/npm/dm/nworks.svg)](https://www.npmjs.com/package/nworks)
+[![npm version](https://img.shields.io/npm/v/nworks-plus.svg)](https://www.npmjs.com/package/nworks-plus)
+[![license](https://img.shields.io/npm/l/nworks-plus.svg)](LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/nworks-plus.svg)](https://www.npmjs.com/package/nworks-plus)
 [![nworks MCP server](https://glama.ai/mcp/servers/yjcho9317/nworks/badges/score.svg)](https://glama.ai/mcp/servers/yjcho9317/nworks)
 
 Featured in [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)
@@ -19,7 +19,7 @@ CLI + MCP server — 28 tools covering messages, calendar, drive, mail, tasks, a
 ## Quickstart
 
 ```bash
-npm install -g nworks
+npm install -g nworks-plus
 nworks login --user
 nworks calendar list
 ```
@@ -49,8 +49,8 @@ Claude → nworks_mail_read (each)
 ## Install
 
 ```bash
-npx nworks             # Run directly
-npm install -g nworks  # Global install
+npx nworks-plus             # Run directly
+npm install -g nworks-plus  # Global install
 ```
 
 ## Login
@@ -104,7 +104,7 @@ One login enables all 28 tools. No extra env setup needed.
 
 > Without CLI login, an AI agent can call `nworks_setup` → `nworks_login_user` to authenticate via browser directly. Client Secret and Private Key path must be pre-configured via MCP config `env` field or system environment variables.
 
-### MCP Tools (28)
+### MCP Tools (31)
 
 | Tool | Description | Auth |
 |------|-------------|------|
@@ -128,6 +128,9 @@ One login enables all 28 tools. No extra env setup needed.
 | `nworks_drive_list` | List drive files/folders | User OAuth (file.read) |
 | `nworks_drive_upload` | Upload file to drive | User OAuth (file) |
 | `nworks_drive_download` | Download file (saves locally if >5MB) | User OAuth (file.read) |
+| `nworks_drive_sharedrive_list` | List team shared drives | User OAuth (file.read) |
+| `nworks_drive_sharedrive_files` | List files in a shared drive | User OAuth (file.read) |
+| `nworks_drive_sharedrive_download` | Download a file from a shared drive | User OAuth (file.read) |
 | **Mail** | | |
 | `nworks_mail_send` | Send mail | User OAuth (mail) |
 | `nworks_mail_list` | List mailbox | User OAuth (mail.read) |
@@ -248,6 +251,17 @@ nworks drive download --file-id <fileId>
 
 # Specify output path/name
 nworks drive download --file-id <fileId> --out ./downloads --name report.pdf
+
+# ── Shared drives (team storage, separate from personal "My Drive") ──
+# List shared drives (get sharedriveId)
+nworks drive sharedrive-list
+
+# List files in a shared drive (root, then drill into a folder)
+nworks drive sharedrive-files --drive <sharedriveId>
+nworks drive sharedrive-files --drive <sharedriveId> --folder <fileId>
+
+# Download a file from a shared drive
+nworks drive sharedrive-download --drive <sharedriveId> --file-id <fileId> --out ./downloads
 ```
 
 ### Mail (User OAuth)
@@ -399,7 +413,7 @@ Sensitive values (Client Secret, Private Key path) must be set via MCP config `e
   "mcpServers": {
     "nworks": {
       "command": "npx",
-      "args": ["-y", "nworks", "mcp"],
+      "args": ["-y", "nworks-plus", "mcp"],
       "env": {
         "NWORKS_CLIENT_SECRET": "<Client Secret>",
         "NWORKS_PRIVATE_KEY_PATH": "<Private Key file absolute path (for Service Account)>"

package/dist/index.js

@@ -1576,8 +1576,7 @@ Content-Type: application/octet-stream\r
   if (!uploadRes.ok) return handleError2(uploadRes);
   return await uploadRes.json();
 }
-async function downloadFile(fileId, userId = "me", profile = "default") {
-  const url = `${BASE_URL3}/users/${sanitizePathSegment(userId)}/drive/files/${sanitizePathSegment(fileId)}/download`;
+async function downloadViaRedirect(url, profile) {
   if (process.env["NWORKS_VERBOSE"] === "1") {
     console.error(`[nworks] GET ${url} (get download URL)`);
   }
@@ -1612,6 +1611,48 @@ async function downloadFile(fileId, userId = "me", profile = "default") {
   }
   return { buffer, fileName };
 }
+async function downloadFile(fileId, userId = "me", profile = "default") {
+  const url = `${BASE_URL3}/users/${sanitizePathSegment(userId)}/drive/files/${sanitizePathSegment(fileId)}/download`;
+  return downloadViaRedirect(url, profile);
+}
+async function listSharedDrives(count = 100, cursor, profile = "default") {
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  const url = `${BASE_URL3}/sharedrives?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url}`);
+  }
+  const res = await authedFetch2(url, { method: "GET" }, profile);
+  if (!res.ok) return handleError2(res);
+  const data = await res.json();
+  const raw = data.sharedDrives ?? data.sharedrives ?? [];
+  const sharedDrives = raw.map((d) => ({
+    sharedriveId: d.sharedriveId,
+    name: d.name ?? d.sharedriveName ?? "",
+    permissionType: d.permissionType
+  }));
+  return { sharedDrives, responseMetaData: data.responseMetaData };
+}
+async function listSharedDriveFiles(sharedriveId, folderId, count = 20, cursor, profile = "default") {
+  const base = `${BASE_URL3}/sharedrives/${sanitizePathSegment(sharedriveId)}/files`;
+  const path = folderId ? `${base}/${sanitizePathSegment(folderId)}/children` : base;
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  const url = `${path}?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url}`);
+  }
+  const res = await authedFetch2(url, { method: "GET" }, profile);
+  if (!res.ok) return handleError2(res);
+  const data = await res.json();
+  return { files: data.files ?? [], responseMetaData: data.responseMetaData };
+}
+async function downloadSharedDriveFile(sharedriveId, fileId, profile = "default") {
+  const url = `${BASE_URL3}/sharedrives/${sanitizePathSegment(sharedriveId)}/files/${sanitizePathSegment(fileId)}/download`;
+  return downloadViaRedirect(url, profile);
+}
 
 // src/commands/drive.ts
 var listCommand2 = new Command7("list").description("List files in Drive (requires User OAuth with file or file.read scope)").option("--user <userId>", "Target user ID (default: me)").option("--folder <folderId>", "Folder ID to list (default: root)").option("--count <n>", "Items per page (default: 20)", "20").option("--cursor <cursor>", "Pagination cursor").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
@@ -1705,7 +1746,78 @@ var downloadCommand = new Command7("download").description("Download a file from
     cliError(err, opts, "drive");
   }
 });
-var driveCommand = new Command7("drive").description("Drive operations (requires User OAuth with file scope)").addCommand(listCommand2).addCommand(uploadCommand).addCommand(downloadCommand);
+var sharedriveListCommand = new Command7("sharedrive-list").description("List shared drives (requires User OAuth with file or file.read scope)").option("--count <n>", "Items per page (default: 100)", "100").option("--cursor <cursor>", "Pagination cursor").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listSharedDrives(
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.profile
+    );
+    output(
+      {
+        sharedDrives: result.sharedDrives,
+        count: result.sharedDrives.length,
+        nextCursor: result.responseMetaData?.nextCursor ?? null
+      },
+      opts
+    );
+  } catch (err) {
+    cliError(err, opts, "drive");
+  }
+});
+var sharedriveFilesCommand = new Command7("sharedrive-files").description("List files in a shared drive (requires User OAuth with file or file.read scope)").requiredOption("--drive <sharedriveId>", "Shared drive ID (from `drive sharedrive-list`)").option("--folder <fileId>", "Folder ID to list (default: shared drive root)").option("--count <n>", "Items per page (default: 20)", "20").option("--cursor <cursor>", "Pagination cursor").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listSharedDriveFiles(
+      opts.drive,
+      opts.folder,
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.profile
+    );
+    const files = result.files.map((f) => ({
+      name: f.fileName,
+      type: f.fileType,
+      size: f.fileSize,
+      modified: f.modifiedTime,
+      fileId: f.fileId
+    }));
+    output(
+      {
+        files,
+        count: files.length,
+        nextCursor: result.responseMetaData?.nextCursor ?? null
+      },
+      opts
+    );
+  } catch (err) {
+    cliError(err, opts, "drive");
+  }
+});
+var sharedriveDownloadCommand = new Command7("sharedrive-download").description("Download a file from a shared drive (requires User OAuth with file or file.read scope)").requiredOption("--drive <sharedriveId>", "Shared drive ID (from `drive sharedrive-list`)").requiredOption("--file-id <fileId>", "File ID to download (from `drive sharedrive-files`)").option("--out <path>", "Output directory (default: current directory)").option("--name <filename>", "Output filename (default: original name)").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await downloadSharedDriveFile(
+      opts.drive,
+      opts.fileId,
+      opts.profile
+    );
+    const fileName = opts.name ?? result.fileName ?? opts.fileId;
+    const outDir = opts.out ?? process.cwd();
+    const outPath = join2(outDir, fileName);
+    await writeFile2(outPath, result.buffer);
+    output(
+      {
+        success: true,
+        fileName,
+        path: outPath,
+        size: result.buffer.length
+      },
+      opts
+    );
+  } catch (err) {
+    cliError(err, opts, "drive");
+  }
+});
+var driveCommand = new Command7("drive").description("Drive operations (requires User OAuth with file scope)").addCommand(listCommand2).addCommand(uploadCommand).addCommand(downloadCommand).addCommand(sharedriveListCommand).addCommand(sharedriveFilesCommand).addCommand(sharedriveDownloadCommand);
 
 // src/commands/mail.ts
 import { writeFile as writeFile3 } from "fs/promises";
@@ -3135,6 +3247,111 @@ OAuth Redirect URI: http://localhost:9876/callback`,
       }
     }
   );
+  server.tool(
+    "nworks_drive_sharedrive_list",
+    "\uD300 \uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C(Shared Drive) \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4. \uAC1C\uC778 '\uB0B4 \uB4DC\uB77C\uC774\uBE0C'\uAC00 \uC544\uB2CC \uD300 \uACF5\uC720 \uC800\uC7A5\uC18C\uB97C \uCC3E\uC744 \uB54C \uC0AC\uC6A9. '\uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C \uBCF4\uC5EC\uC918', '\uD300 \uB4DC\uB77C\uC774\uBE0C \uBAA9\uB85D' \uB4F1\uC758 \uC694\uCCAD\uC5D0 \uC0AC\uC6A9. \uBC18\uD658\uB41C sharedriveId\uB85C nworks_drive_sharedrive_files\uB97C \uD638\uCD9C\uD574 \uB0B4\uBD80 \uD30C\uC77C\uC744 \uC870\uD68C\uD558\uC138\uC694. User OAuth \uC778\uC99D \uD544\uC694 (file.read scope)",
+    {
+      count: z.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 100)"),
+      cursor: z.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C")
+    },
+    async ({ count, cursor }) => {
+      try {
+        const result = await listSharedDrives(count ?? 100, cursor);
+        return {
+          content: [{ type: "text", text: JSON.stringify({ sharedDrives: result.sharedDrives, count: result.sharedDrives.length, hasMore: !!result.responseMetaData?.nextCursor, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: mcpErrorHint(err, "drive.list") }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_drive_sharedrive_files",
+    "\uD2B9\uC815 \uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C(Shared Drive) \uC548\uC758 \uD30C\uC77C/\uD3F4\uB354 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4. sharedriveId\uB294 nworks_drive_sharedrive_list\uB85C \uC870\uD68C \uAC00\uB2A5. folderId\uB97C \uC9C0\uC815\uD558\uBA74 \uD574\uB2F9 \uD3F4\uB354 \uB0B4\uBD80\uB97C, \uBBF8\uC9C0\uC815 \uC2DC \uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C \uB8E8\uD2B8\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4. User OAuth \uC778\uC99D \uD544\uC694 (file.read scope)",
+    {
+      sharedriveId: z.string().describe("\uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C ID (nworks_drive_sharedrive_list\uB85C \uC870\uD68C \uAC00\uB2A5)"),
+      folderId: z.string().optional().describe("\uD3F4\uB354 ID (\uBBF8\uC9C0\uC815 \uC2DC \uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C \uB8E8\uD2B8)"),
+      count: z.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 20, \uCD5C\uB300: 200)"),
+      cursor: z.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C")
+    },
+    async ({ sharedriveId, folderId, count, cursor }) => {
+      try {
+        const result = await listSharedDriveFiles(sharedriveId, folderId, count ?? 20, cursor);
+        const files = result.files.map((f) => ({
+          fileId: f.fileId,
+          name: f.fileName,
+          type: f.fileType,
+          size: f.fileSize,
+          modified: f.modifiedTime,
+          path: f.filePath
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ files, count: files.length, hasMore: !!result.responseMetaData?.nextCursor, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: mcpErrorHint(err, "drive.list") }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_drive_sharedrive_download",
+    "\uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C(Shared Drive)\uC758 \uD30C\uC77C\uC744 \uB2E4\uC6B4\uB85C\uB4DC\uD569\uB2C8\uB2E4. sharedriveId\xB7fileId\uB294 nworks_drive_sharedrive_files\uB85C \uC870\uD68C \uAC00\uB2A5. outputDir\uC744 \uC9C0\uC815\uD558\uBA74 \uB85C\uCEEC\uC5D0 \uD30C\uC77C\uB85C \uC800\uC7A5\uD558\uACE0, \uBBF8\uC9C0\uC815 \uC2DC \uD30C\uC77C \uB0B4\uC6A9\uC744 \uC9C1\uC811 \uBC18\uD658\uD569\uB2C8\uB2E4 (\uD14D\uC2A4\uD2B8\uB294 text, \uBC14\uC774\uB108\uB9AC\uB294 base64). 5MB \uCD08\uACFC \uD30C\uC77C\uC740 \uBC18\uB4DC\uC2DC outputDir\uB97C \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4. User OAuth \uC778\uC99D \uD544\uC694 (file.read scope)",
+    {
+      sharedriveId: z.string().describe("\uACF5\uC720 \uB4DC\uB77C\uC774\uBE0C ID (nworks_drive_sharedrive_list\uB85C \uC870\uD68C \uAC00\uB2A5)"),
+      fileId: z.string().describe("\uB2E4\uC6B4\uB85C\uB4DC\uD560 \uD30C\uC77C ID (nworks_drive_sharedrive_files\uB85C \uC870\uD68C \uAC00\uB2A5)"),
+      outputDir: z.string().optional().describe("\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC (\uC9C0\uC815 \uC2DC \uD30C\uC77C\uB85C \uC800\uC7A5, \uBBF8\uC9C0\uC815 \uC2DC \uB0B4\uC6A9\uC744 \uC9C1\uC811 \uBC18\uD658)"),
+      outputName: z.string().optional().describe("\uC800\uC7A5 \uD30C\uC77C\uBA85 (\uBBF8\uC9C0\uC815 \uC2DC \uC6D0\uBCF8 \uD30C\uC77C\uBA85)")
+    },
+    async ({ sharedriveId, fileId, outputDir, outputName }) => {
+      try {
+        const result = await downloadSharedDriveFile(sharedriveId, fileId);
+        const fileName = outputName ?? result.fileName ?? fileId;
+        if (outputDir) {
+          const { writeFile: writeFile4 } = await import("fs/promises");
+          const { join: join4 } = await import("path");
+          const safeDir = validateLocalPath(outputDir);
+          const safeName = sanitizeFileName(fileName);
+          const outPath = join4(safeDir, safeName);
+          validateLocalPath(outPath, safeDir);
+          await writeFile4(outPath, result.buffer);
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, fileName, path: outPath, size: result.buffer.length }) }]
+          };
+        }
+        const MAX_INLINE_SIZE = 5 * 1024 * 1024;
+        if (result.buffer.length > MAX_INLINE_SIZE) {
+          const sizeMB = (result.buffer.length / (1024 * 1024)).toFixed(1);
+          return {
+            content: [{ type: "text", text: JSON.stringify({ error: true, message: `\uD30C\uC77C\uC774 \uB108\uBB34 \uD07D\uB2C8\uB2E4 (${sizeMB}MB). outputDir\uB97C \uC9C0\uC815\uD574\uC11C \uB85C\uCEEC\uC5D0 \uC800\uC7A5\uD558\uC138\uC694.`, fileName, size: result.buffer.length }) }],
+            isError: true
+          };
+        }
+        const textExtensions = /\.(txt|md|csv|json|xml|html|htm|css|js|ts|jsx|tsx|yaml|yml|toml|ini|cfg|conf|log|sh|bash|zsh|py|rb|java|go|rs|c|cpp|h|hpp|sql|graphql|env|gitignore|dockerignore|editorconfig)$/i;
+        const isText = textExtensions.test(fileName);
+        if (isText) {
+          const text = result.buffer.toString("utf-8");
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, fileName, size: result.buffer.length, encoding: "text", content: text }) }]
+          };
+        }
+        const base64 = result.buffer.toString("base64");
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, fileName, size: result.buffer.length, encoding: "base64", content: base64 }) }]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: mcpErrorHint(err, "drive.download") }],
+          isError: true
+        };
+      }
+    }
+  );
   server.tool(
     "nworks_mail_send",
     "NAVER WORKS \uBA54\uC77C\uC744 \uC804\uC1A1\uD569\uB2C8\uB2E4. '\uBA54\uC77C \uBCF4\uB0B4\uC918', '\uC774\uBA54\uC77C \uC791\uC131\uD574\uC918' \uB4F1\uC758 \uC694\uCCAD\uC5D0 \uC0AC\uC6A9. \uBE44\uB3D9\uAE30 \uC804\uC1A1(\uC131\uACF5 \uC2DC 202). User OAuth \uC778\uC99D \uD544\uC694 (mail scope)",