NAVER WORKS CLI and MCP server for messages, calendar, drive, mail, and tasks.
nworks
Featured in awesome-mcp-servers
πΊπΈ English | π°π· νκ΅μ΄ | π―π΅ ζ₯ζ¬θͺ
Full-featured MCP server for LINE WORKS (NAVER WORKS). CLI + MCP server β 26 tools covering messages, calendar, drive, mail, tasks, and boards.
Quickstart
npm install -g nworks
nworks login --user
nworks calendar list
AI Agents Actually Use It Like This
User: Show me today's schedule
Claude β nworks_calendar_list
β 3 events: Standup (10:00), Lunch meeting (12:00), Code review (15:00)
User: Send a deploy complete message to the team channel
Claude β nworks_message_send
{ "channel": "C001", "text": "v1.2.0 deploy complete" }
β Message sent
User: Check my unread emails and summarize them
Claude β nworks_mail_list (unread)
β 3 unread emails
Claude β nworks_mail_read (each)
β "3 unread: 1) Deploy approval from CTO, 2) Meeting invite for Friday, 3) Weekly report reminder"
Install
npx nworks # Run directly
npm install -g nworks # Global install
Login
# User OAuth (calendar, drive, mail, tasks, boards)
nworks login --user --scope "calendar calendar.read file file.read mail mail.read task task.read board board.read user.read"
# Bot messaging (Service Account)
nworks login
# Check auth status
nworks whoami
# Logout
nworks logout
nworks login --useronly requires CLIENT_ID + CLIENT_SECRET. Values already set via environment variables or existing config won't be asked again.
Developer Console: To use User OAuth, register
http://localhost:9876/callbackas a Redirect URL in the Developer Console.
AI Agent Integration (MCP Server)
Works with Claude Desktop, Cursor, and other MCP-compatible clients.
Setup
Login first:
nworks login --user --scope "calendar calendar.read file file.read mail mail.read task task.read board board.read user.read"
Then add to your MCP config (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"nworks": {
"command": "nworks",
"args": ["mcp"]
}
}
}
One login enables all 26 tools. No extra env setup needed.
Without CLI login, an AI agent can call
nworks_setupβnworks_login_userto authenticate via browser directly. Client Secret and Private Key path must be pre-configured via MCP configenvfield or system environment variables.
MCP Tools (26)
| Tool | Description | Auth |
|---|---|---|
| Setup / Auth | ||
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 | Service Account |
nworks_message_members |
List channel members | Service Account |
nworks_directory_members |
List organization members | Service Account |
| Calendar | ||
nworks_calendar_list |
List calendar events | User OAuth (calendar.read) |
nworks_calendar_create |
Create calendar event | User OAuth (calendar + calendar.read) |
nworks_calendar_update |
Update calendar event | User OAuth (calendar + calendar.read) |
nworks_calendar_delete |
Delete calendar event | User OAuth (calendar + calendar.read) |
| Drive | ||
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_mail_send |
Send mail | User OAuth (mail) |
nworks_mail_list |
List mailbox | User OAuth (mail.read) |
nworks_mail_read |
Read mail detail | User OAuth (mail.read) |
| Tasks | ||
nworks_task_list |
List tasks | User OAuth (task.read) |
nworks_task_create |
Create task | User OAuth (task + user.read) |
nworks_task_update |
Update/complete task | User OAuth (task + user.read) |
nworks_task_delete |
Delete task | User OAuth (task + user.read) |
| Boards | ||
nworks_board_list |
List boards | User OAuth (board.read) |
nworks_board_posts |
List board posts | User OAuth (board.read) |
nworks_board_read |
Read board post detail | User OAuth |
Tools (5)
nworks_message_sendSend message to user or channelnworks_calendar_listList calendar eventsnworks_mail_listList mailboxnworks_drive_listList drive files and foldersnworks_task_listList tasksEnvironment Variables
CLIENT_IDrequiredNAVER WORKS API Client IDCLIENT_SECRETrequiredNAVER WORKS API Client SecretConfiguration
{"mcpServers": {"nworks": {"command": "nworks", "args": ["mcp"]}}}