# yjcho9317/nworks [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/yjcho9317/nworks  
**GitHub Stars:** 24  
**npm Downloads (last month):** 193  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yjcho9317-nworks

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

## Tools
Capabilities this server exposes over MCP:

- **Setup**
- **nworks_setup** — Configure API credentials (Client ID, etc.). Client Secret is set via env
- **nworks_login_user** — User OAuth browser login (all scopes included)
- **nworks_logout** — Delete credentials and tokens
- **nworks_whoami** — Check auth status
- **nworks_doctor** — Diagnose connection (auth, tokens, API health)
- **Messages**
- **nworks_message_send** — Send message to user/channel
- **nworks_message_members** — List channel members
- **nworks_directory_members** — List organization members
- **Calendar**
- **nworks_calendar_list** — List calendar events
- **nworks_calendar_create** — Create calendar event
- **nworks_calendar_update** — Update calendar event
- **nworks_calendar_delete** — Delete calendar event
- **Drive**
- **nworks_drive_list** — List drive files/folders
- **nworks_drive_upload** — Upload file to drive
- **nworks_drive_download** — Download file (saves locally if >5MB)
- **Mail**
- **nworks_mail_send** — Send mail
- **nworks_mail_list** — List mailbox
- **nworks_mail_read** — Read mail detail
- **Tasks**
- **nworks_task_list** — List tasks
- **nworks_task_create** — Create task
- **nworks_task_update** — Update/complete task
- **nworks_task_delete** — Delete task
- **Boards**
- **nworks_board_list** — List boards
- **nworks_board_posts** — List board posts
- **nworks_board_read** — Read board post detail
- **nworks_board_create** — Create board post

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "nworks": {
    "command": "npx",
    "args": ["-y","nworks"],
    "env": {
      "CLIENT_ID": "",
      "CLIENT_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `CLIENT_ID`, `CLIENT_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What yjcho9317/nworks MCP server does

yjcho9317/nworks MCP server connects external AI agents and terminal workflows to NAVER WORKS, also referred to in the project as LINE WORKS. Its tools cover common workplace operations rather than a single narrow resource. Agents can send messages, inspect channel or organization members, manage calendar events, browse and transfer Drive files, read and send mail, maintain tasks, and work with boards and contacts.

The project also includes authentication and troubleshooting tools. An agent can configure credentials, start user login, remove stored credentials, check the active identity, and run a connection diagnosis. This makes the server usable both from an existing CLI login and from an MCP client that needs to guide setup.

## How it works

The package runs locally and exposes its MCP interface through the `nworks mcp` command. MCP clients such as Claude Desktop and Cursor can launch that command as a stdio server. The same package also provides terminal commands for login and direct NAVER WORKS operations, with JSON output available for scripting and agent workflows.

Most calendar, Drive, mail, task, board, and contact operations use NAVER WORKS user OAuth scopes. Messaging and organization or channel member operations use the service-account-based bot API. User login opens a browser flow and can request the supported scopes together. A single successful login makes the available authorized tools usable by the client, subject to the scopes and account permissions granted.

## Setup and configuration

Before using yjcho9317/nworks MCP server, create an application in the NAVER WORKS Developer Console. The documented user OAuth flow requires a client ID, client secret, and the redirect URL `http://localhost:9876/callback` registered in that console. Bot messaging may also require administrator approval.

Install the npm package globally or run it directly with `npx`. After installation, authenticate with `nworks login --user` for user features, or use the bot login flow for messaging. The MCP configuration starts `nworks` with the `mcp` argument. Credentials can also be prepared through `nworks_setup` and `nworks_login_user`; the client secret and private-key path must be supplied through the MCP environment configuration or the system environment when required.

## Tools and capabilities

- Send messages to users or channels and list channel members.
- List organization members through the directory tools.
- List, create, update, and delete calendar events.
- List, upload, and download Drive files and folders.
- Send mail, list a mailbox, read messages, and download attachments.
- List, create, update, complete, and delete tasks.
- List boards and work with board posts where the corresponding tools and scopes are available.
- List, read, create, update, delete, and tag contacts.
- Check authentication state and diagnose API connectivity.

## Limitations and notes

yjcho9317/nworks MCP server is unofficial and community-maintained, and the repository states that it is not affiliated with LINE WORKS or NAVER WORKS. Access depends on a correctly configured Developer Console application, OAuth scopes, service-account permissions, and any required administrator approval. File and attachment downloads larger than 5 MB are saved locally according to the project documentation. The material identifies Claude Desktop and Cursor as compatible clients, while other MCP-compatible clients may require their own stdio configuration.

_Full upstream README: https://allmcps.com/mcp/yjcho9317-nworks/readme_