用途
nworks 是一个面向 LINE WORKS（NAVER WORKS）的全功能 MCP 服务器与 CLI 工具，由社区维护，属于非官方项目，与 LINE WORKS / NAVER WORKS 无隶属关系。它的目标是从外部让 AI 智能体（如 Claude、Cursor）和终端操作 LINE WORKS，作为 LINE WORKS 自带产品内 AI（AiStudio、WORKS AI）的补充，而不是替代品。
主要能力
根据资料，nworks 提供 36 个工具，覆盖以下模块：
- 消息（Messages，Bot API）
- 日历（Calendar，User OAuth）
- 云盘（Drive，User OAuth）
- 邮件（Mail，User OAuth）
- 任务（Tasks，User OAuth）
- 看板（Boards，User OAuth）
- 联系人（Contacts，User OAuth）
所有命令支持 --json，便于管道、脚本或智能体解析。message send、mail send 和 drive upload 支持 --dry-run，可在不实际发送的情况下进行测试。
使用方式
前置准备
首次使用需要：Developer Console 应用（Client ID/Secret）、注册的重定向 URL；若使用机器人消息，还需要管理员审批。使用 User OAuth 时，需在 Developer Console 中注册 http://localhost:9876/callback 作为重定向 URL。
CLI 登录
nworks login --user 只需要 CLIENT_ID + CLIENT_SECRET。已通过环境变量或现有配置设置的值不会被再次询问。
AI 智能体集成（MCP 服务器）
可与 Claude Desktop、Cursor 及其他兼容 MCP 的客户端配合使用。将配置添加到 MCP 配置文件（~/.config/claude/claude_desktop_config.json）后，一次登录即可启用全部 36 个工具，无需额外环境设置。
如果不通过 CLI 登录，AI 智能体可以调用 nworks_setup → nworks_login_user，直接通过浏览器进行认证。Client Secret 和 Private Key 路径必须预先通过 MCP 配置的 env 字段或系统环境变量设置。
环境变量
设置环境变量后，无需 nworks login 即可使用 nworks，适用于 CI/智能体场景。敏感值（Client Secret、Private Key 路径）必须通过 MCP 配置的 env 字段设置；非敏感值（如 Client ID）可由 AI 智能体通过 nworks_setup 工具配置。
权限范围（Scopes）
需要在 LINE WORKS Developer Console 中添加所需 scopes。可使用预设（presets），比逐个列出 scopes 更简单：default 是 all 的别名。消息发送使用 Service Account（机器人），因此无论预设如何都能工作。重新登录不会缩小访问权限——新请求的 scopes 会与现有 token 合并，因此切换预设只会增加能力。如需手动指定，可使用 --scope "calendar calendar.read"。
联系人创建
contact create 需要 contactName 和 permission；permission.accessibleMembers 必须至少列出一个成员（通常是用户自己）。可通过 nworks whoami 获取自己的用户 ID。
适用场景
- AI 智能体集成：让 Claude、Cursor 等 MCP 兼容客户端操作 LINE WORKS。
- 终端自动化：通过 CLI 脚本操作 LINE WORKS。
- CI/CD 部署通知。
- 团队自动化脚本。
限制
- 非官方、社区维护，与 LINE WORKS / NAVER WORKS 无隶属关系。
- 首次使用需要 Developer Console 应用、重定向 URL 注册，机器人消息还需管理员审批。
- 敏感值必须通过 MCP 配置 env 字段或系统环境变量设置。
- 资料中未提供收费、价格、平台支持范围、具体效果等更多信息。
