yjcho9317/nworks

Featured in awesome-mcp-servers
🇺🇸 English | 🇰🇷 한국어 | 🇯🇵 日本語
Full-featured MCP server for LINE WORKS (NAVER WORKS).
CLI + MCP server — 36 tools covering messages, calendar, drive, mail, tasks, and boards.
nworks lets **external** AI agents (Claude, Cursor) and your terminal *operate* LINE WORKS from the outside — complementary to LINE WORKS' own in-product AI (AiStudio, WORKS AI), not a replacement. Unofficial and community-maintained; not affiliated with LINE WORKS / NAVER WORKS.
Quickstart
> **First time?** You first need a Developer Console app (Client ID/Secret), a registered redirect URL, and — for bot messaging — admin approval. See the Onboarding & Admin Setup guide.
AI Agents Actually Use It Like This
Install
Login
> nworks login --user only 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/callback as 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:
Then add to your MCP config (~/.config/claude/claude_desktop_config.json):
One login enables all 36 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 (32)
| 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_sharedrive_list | List shared drives | User OAuth (file.read) |
| nworks_sharedrive_files | List files/folders in a shared drive | User OAuth (file.read) |
| nworks_sharedrive_download | Download a shared drive file (saves locally if >5MB) | User OAuth (file.read) |
| **Mail** | | |
| 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) |
| nworks_mail_download_attachment | Download a mail attachment (saves locally if >5MB) | User OAuth (mail.read) |