Nworks

Name: Nworks
Author: yjcho9317

@yjcho9317

关于 Nworks

NAVER WORKS CLI + MCP server. 26 tools for messages, calendar, drive, mail, tasks, and boards. AI agents can manage NAVER WORKS directly.

#naver-works #mcp #cli #ai-agent #communication #typescript

基本信息

分类

其他

传输方式

stdio

发布者

yjcho9317

提交者

yjcho9317

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "nworks": {
      "command": "nworks",
      "args": [
        "mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Nworks?

Nworks is the first full MCP server for NAVER WORKS, providing a CLI and MCP server that makes NAVER WORKS APIs easy to use from scripts or AI agents. It automates messages, calendar, drive, mail, tasks, and boards — from CLI or AI agents.

How to use Nworks?

Install globally via npm (npm install -g nworks), then run nworks login --user for User OAuth authentication. Use CLI commands like nworks calendar list directly, or add nworks as an MCP server in your Claude Desktop or Cursor configuration to access 26 tools through AI agents.

Features of Nworks

First full MCP server for NAVER WORKS
26 MCP tools: messages, calendar, drive, mail, tasks, boards
CLI with --json support for scripting and AI parsing
User OAuth and Service Account authentication
One-time login for all 26 tools — no separate env setup needed
AI agents can self-configure without prior CLI login

Use cases of Nworks

Automate NAVER WORKS workflows from AI agents (Claude, Cursor)
Send CI/CD deployment notifications to team channels
Schedule calendar events and send reminders automatically
Manage tasks, mail, and board posts from scripts
Upload/download files to NAVER WORKS Drive programmatically

FAQ from Nworks

What authentication methods does Nworks support?

User OAuth (for calendar, drive, mail, tasks, boards) and Service Account (for bot messaging and directory). Use nworks login --user for User OAuth, or set environment variables like NWORKS_CLIENT_ID for passwordless setup.

What runtime or dependencies are required?

Node.js (via npm). Install with npm install -g nworks or run directly with npx nworks. No additional runtime dependencies beyond NAVER WORKS Developer Console app credentials.

Where does Nworks store authentication data?

Authentication tokens and credentials are stored locally after running nworks login. The nworks logout command deletes stored credentials and tokens. Environment variables can also be used instead of stored login.

What are the known limits of Nworks?

Drive downloads over 5MB are saved locally instead of returned inline. Bots require Service Account credentials (NWORKS_SERVICE_ACCOUNT, NWORKS_PRIVATE_KEY_PATH, NWORKS_BOT_ID) for message sending and directory access.

What transports and protocols does Nworks use?

Nworks communicates with NAVER WORKS via HTTPS REST APIs. It supports both direct CLI invocation and the Model Context Protocol (MCP) for integration with AI agents like Claude Desktop and Cursor.