kmsg

# Tool List [](LICENSE) [](https://github.com/channprj/kmsg/releases) [Project Homepage](https://channprj.github.io/kmsg/) · [English](README.en.md) <p><img src="assets/kmsg-logo.jpg" alt="kmsg logo" width="220" /></p> `kmsg` is an unofficial KakaoTalk CLI and native MCP server for macOS. It provides easy-to-use APIs to read, monitor, and send messages, and structured outputs for local automation and AI agents. > **Disclaimer**: `kmsg` is not an official tool of Kakao Corp. > Users are responsible for complying with relevant laws, service terms, and company security policies in their own accounts and environments. > Users are responsible for any account restrictions, malfunctions, data loss, or other damages caused by using this tool. > For my personal judgment on why I used AX instead of LOCO Protocol and the possibility of account penalties, please refer to [Why not use LOCO Protocol of KakaoTalk?](ARCHITECTURE.md#accessibility-instead-of-a-private-protocol). ## Demo https://github.com/user-attachments/assets/c620b2e3-7106-40fa-86d1-ed847e3b1a6f ## User Reviews <a href="https://www.youtube.com/watch?v=_Pd1G33_R48&t=1020s"><img src="https://i.ytimg.com/vi/_Pd1G33_R48/maxresdefault.jpg" alt="User Review: Hermes Agent 5 Automation" width="400" /></a> **Builder Josh:** [Hermes Agent 5 Automation](https://www.youtube.com/watch?v=_Pd1G33_R48&t=1020s) — from 17:00 <a href="https://www.youtube.com/watch?v=xz5fA7OyvQ0"><img src="https://i.ytimg.com/vi/xz5fA7OyvQ0/maxresdefault.jpg" alt="User Review: Building Hermes System" width="400" /></a> **Sam Horton:** [Building Hermes System](https://www.youtube.com/watch?v=xz5fA7OyvQ0) ## Key Features - Retrieve chat lists and generate reusable local `chat_id`. - Read recent messages or monitor new messages in real-time. - Control KakaoTalk UI to send text and images. - Output structured JSON to `stdout` and AX tracking logs to `stderr`. - Run native stdio MCP server providing read, text send, and image send tools. - Support background-safe reading, window layout, recovery mode, and self-healing AX path cache. ## Requirements - macOS 13 or later - [KakaoTalk for macOS](https://apps.apple.com/kr/app/kakaotalk/id869223134?mt=12) - Easy access permission for installed `kmsg` binary ## Installation Recommended installation via Homebrew. ```bash brew install channprj/tap/kmsg ``` For manual download and source build, refer to [USAGE.md](USAGE.md#installation). ## Quick Start ```bash kmsg status kmsg chats kmsg read "Chat Room Name" --limit 20 kmsg send "Chat Room Name" "Hello" --dry-run ``` `kmsg status` requests easy access permission and checks login status if necessary. The last command is a dry run and does not send an actual message. ## Documentation - [Usage](USAGE.md) — Installation, commands, configuration, examples, and troubleshooting - [Architecture](ARCHITECTURE.md) — Components, data flow, state, and design decisions - [OpenClaw Integration](docs/openclaw.md) — MCP and real-time watch integration - [Versioning](VERSIONING.md) — Release format and automation - [English README](README.en.md) — English version of this document ## Frequently Asked Questions ### What is kmsg? `kmsg` is an unofficial open-source KakaoTalk CLI and native MCP server for macOS. It allows users, scripts, and AI agents to read, monitor, and send KakaoTalk messages from the command line. ### Is kmsg an official KakaoTalk tool? No, `kmsg` is not an official tool of Kakao Corp. and is an independently managed open-source project. ### Which operating systems are supported? `kmsg` requires macOS 13 or later and KakaoTalk for macOS. Windows, Linux, Android, and iOS are not supported. ### How does kmsg access KakaoTalk? It controls the KakaoTalk application displayed on the screen using Apple's macOS accessibility API. It does not implement KakaoTalk's private LOCO protocol. ### Does kmsg include an MCP server? Yes, the native `kmsg mcp-server` command provides read, text send, and image send tools via stdio for MCP-compatible clients and AI agents. ### How do I install kmsg? You can install it using Homebrew: `brew install channprj/tap/kmsg`. For manual download and source build, refer to [Usage](USAGE.md). ## Inspiration This project was heavily inspired by [steipete](https://github.com/steipete) and his [imsg](https://github.com/steipete/imsg), as well as [OpenClaw](https://github.com/openclaw/openclaw). ## License `kmsg` is provided under the [MIT License](LICENSE).