Content
# LINE Desktop MCP
[English](#english) |
---
## English
Integrate AI tools with LINE Desktop through MCP (Model Context Protocol) to enable message reading and sending operations.
### ⚠️ Important Notice
**This project is NOT the official LINE line-bot-mcp-server**
If you're looking for the official version, please visit: https://github.com/line/line-bot-mcp-server
### Differences from Official Version
- **Official line-bot-mcp-server**: Operates LINE Bot through LINE Messaging API
- **This project line-desktop-mcp**: Directly operates LINE Desktop application on Windows or Mac through MCP
### Important Disclaimer
1. **This project is NOT officially affiliated with LINE**
2. **No need to apply for LINE Developers or use Channel Access Token**
This project operates through the already logged-in LINE Desktop application, without requiring developer account registration or API tokens.
### About
LINE Desktop MCP is an integration tool based on the Model Context Protocol that allows AI tools (such as Claude Desktop, n8n ) to interact directly with the LINE Desktop application. With this project, you can:
- 📖 Read LINE chat messages
- ✉️ Send LINE messages (manual or automatic)
- 🤖 Integrate LINE into your AI workflows
### Features
- 🤖 **AI Integration**: Seamlessly integrate with AI tools like Claude Desktop, n8n through the MCP protocol
- 💬 **Message Operations**: Support for reading and sending LINE messages
- 🖥️ **Desktop Integration**: Direct interaction with the LINE Desktop application
- 🔄 **Automation Support**: Choose between manual confirmation or automatic message sending
### System Requirements
#### Basic Requirements
- **LINE Desktop**: v9.10 or above
- **Operating System**:
- Windows 10 or above
- macOS Ventura 13.0 or above (requires AppleScript support)
#### Integration with Claude Desktop
- **Claude Desktop App**: Latest version
- **Claude Subscription**: Pro plan
#### Integration with n8n
- **n8n**: Version with MCP support
### Installation
#### Windows
1. **Install Node.js**
- Follow Microsoft's official guide: https://learn.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows
2. **Install AutoHotkey v2**
- Download and install: https://www.autohotkey.com/
3. **Configure Claude Desktop**
- Open Claude Desktop configuration file
- Add the following to `mcpServers`:
```json
{
"mcpServers": {
"line-desktop-mcp": {
"command": "npx",
"args": ["line-desktop-mcp@latest"]
}
}
}
```
#### macOS
1. **Install Node.js**
- Using Homebrew: `brew install node`
- Or download from: https://nodejs.org/
2. **(Optional) Install cliclick**
- If Homebrew is installed, it will be automatically installed on startup
- Or install manually: `brew install cliclick`
3. **Configure Claude Desktop**
- Open Claude Desktop configuration file
- Add the following to `mcpServers`:
```json
{
"mcpServers": {
"line-desktop-mcp": {
"command": "npx",
"args": ["line-desktop-mcp@latest"]
}
}
}
```
### Advanced Configuration
#### Streamable HTTP Mode
In addition to the default stdio mode, this project also supports running via Streamable HTTP. This mode is particularly suitable for use with platforms like **n8n** that support MCP.
**Start Streamable HTTP Mode:**
```bash
# Local use (localhost only)
npx line-desktop-mcp@latest --http-mode --port 3000
# Allow external connections (token required)
npx line-desktop-mcp@latest --http-mode --host 0.0.0.0 --port 3000 --token YOUR_SECRET
```
**Parameters:**
- `--http-mode`: Enable Streamable HTTP mode, using HTTP streaming instead of stdio
- `--port <port>`: Specify the HTTP server port (default: 3000)
- `--host <host>`: Specify the network interface to bind (default: `127.0.0.1`)
- `--token <secret>`: Set Bearer Token authentication secret. Required when `--host` is set to a non-loopback address for security
**MCP Endpoint Configuration:**
Local connection:
```
http://127.0.0.1:3000/mcp
```
n8n in Docker (same machine):
```
http://host.docker.internal:3000/mcp
```
**Transport Method:**
- POST requests: Send JSON-RPC messages and receive responses via SSE stream
- Supports session management with unique session IDs for each connection
**n8n Workflow Example:**
If you want to use LINE Desktop MCP in n8n, you can download our sample workflow file:
- 📥 [Download n8n Workflow Example](doc_media/LINE-Desktop-MCP-Demo-chatbot-sample.json)
This example demonstrates how to integrate LINE Desktop MCP in n8n to create a chatbot workflow.
### Usage
In Claude Desktop conversations, you can interact with LINE in the following ways:
#### 1. Read Chat Messages
```
Please read the messages from LINE group 'Project Discussion' and summarize them
```
#### 2. Send Messages (Manual Confirmation)
```
Please write a greeting and send it to LINE group 'Project Discussion'
```
Claude will compose the message and wait for your confirmation before sending.
#### 3. Send Messages (Automatic)
```
Please write a greeting and send it to LINE group 'Project Discussion', and send it automatically
```
Claude will compose the message and automatically complete the sending action.
### Usage Precautions
#### Important Reminders
1. **Avoid Interfering with Automation**
This tool performs automation through the graphical user interface (GUI). During automated operations, please refrain from using the mouse for other tasks to prevent interference with the program's execution.
2. **LINE Desktop Window Configuration**
Please ensure that LINE Desktop is configured in "Expanded Chat Window" mode. In this mode, the chat window remains docked to the right side of the chat list, rather than opening as a separate independent window.
3. **Multi-Monitor Setup**
If you are using multiple monitors, please ensure that the LINE Desktop application is positioned on the primary display (first monitor) for the automation to function correctly.
### License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
### Author
**Geoffrey Wang**
- GitHub: [@dtwang](https://github.com/dtwang)
- Threads: [@geoff_spacetime](https://www.threads.com/@geoff_spacetime)
