andrew54068/line-cua-mcp

Language: Traditional Chinese (Taiwan) | English README

The LINE Desktop MCP server dedicated to macOS. When reading messages, it reads the read-only snapshot of the LINE locally encrypted database; This read path runs entirely in the background, without touching the UI: no cursor movement, no window focus, no OCR, no scrolling screen, and it can also be read when LINE is closed. Sending messages must be done through the LINE UI, operated by cua-driver without moving the cursor; Before sending, OCR is used to read chat titles and the local database is used to cross-match the target chat.

Experimental Warning

This is an experimental personal tool, not a mature product, nor a formal product that can be safely installed by general users. It reads your local LINE Desktop’s encrypted database and sends messages via the LINE interface when you specifically request. Please treat it as a prototype tool for research or personal use:

• Use only on your own Mac, your own LINE account, and your own data.
• The initial setup requires extracting the local LINE database key; This usually starts a re-signed copy of LINE and prompts you to log in, which may result in the original LINE Desktop being logged out.
• Although sending messages involves cross-matching between OCR and local databases to reduce risk, they should still not be considered zero risk; By default, a draft is left (auto: false), and it is recommended to confirm before submitting.
• LINE updates, macOS permissions, OCR results, database formatting, or cua-driver behavior changes can all disable it.
• You must confirm that your usage complies with LINE’s Terms of Service and local laws. This project is not affiliated with LINE/NAVER and does not represent endorsement or support by LINE/NAVER.

Two Data Paths

• **Reading is the database path. ** LINE Desktop on macOS is the Qt6/QML app, where message text is rendered by the GPU and cannot be accessed in the accessibility tree; However, historical messages are stored locally on wxSQLite3 / QtCipherSqlitePlugin AES-128-CBC and encrypts the SQLite DB (…/Data/db/qwb*.edb). read_history / list_chats uses the account key in macOS keychain to decrypt read-only snapshots and return **the **history records currently stored in the local database (each locally saved message, including sender, timestamp, direction), along with coverage (local count, oldest/latest time). The local database only stores messages that LINE Desktop has been synchronized to this Mac; Older messages that were never loaded locally are not included (can be supplemented with sync_older_messages. This path runs entirely in the background and does not touch the UI. The old version used OCR to read the screen, but only the current screen was visible; That path has been removed.
• **Sending messages is the UI path, but does not move the cursor.