Skip to content
Back to search

kmsg

Unofficial KakaoTalk CLI and native MCP server for macOS — read, watch, and send messages via Accessibility automation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/channprj--kmsg/badge.svg)](/listings/channprj--kmsg)

HTML

<a href="/listings/channprj--kmsg"><img src="/api/listings/channprj--kmsg/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Homebrew 설치를 권장합니다.

brew install channprj/tap/kmsg

이미 설치했다면 다음 명령으로 업데이트합니다.

kmsg update

`kmsg update`는 필요하면 Homebrew를 설치하고, 포뮬러를 설치하거나 업그레이드한 뒤, 직접 설치한 바이너리를 Homebrew 명령으로 연결합니다.

직접 다운로드와 소스 빌드 방법은 [USAGE.md](USAGE.md#installation)를 참고하세요.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 189 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # kmsg — macOS용 카카오톡 CLI 및 MCP 서버
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  3. [![Total downloads](https://img.shields.io/github/downloads/channprj/kmsg/total?label=downloads&logo=github)](https://github.com/channprj/kmsg/releases)
  4. [프로젝트 홈페이지](https://channprj.github.io/kmsg/) · [English](README.en.md)
  5. <p><img src="assets/kmsg-logo.jpg" alt="kmsg logo" width="220" /></p>
  6. `kmsg`는 macOS용 비공식 카카오톡 CLI이자 네이티브 MCP 서버입니다.
  7. macOS 손쉬운 사용 API로 메시지를 읽고, 감시하고, 전송하며 로컬 자동화와
  8. AI 에이전트를 위한 구조화된 출력을 제공합니다.
  9. > **Disclaimer**: `kmsg`는 Kakao Corp. 의 공식 도구가 아닙니다.
  10. > 사용자는 본인 계정/환경에서 관련 법규, 서비스 약관, 회사 보안 정책을 준수할 책임이 있습니다.
  11. > 이 도구 사용으로 발생할 수 있는 계정 제한, 오작동, 데이터 손실, 기타 손해에 대한 책임은 사용자에게 있습니다.
  12. > LOCO Protocol 이 아닌 AX 를 사용한 이유와 계정 제재 가능성에 대한 제 개인적인 판단은 [왜 KakaoTalk 의 LOCO Protocol 을 사용하지 않나요?](ARCHITECTURE.md#accessibility-instead-of-a-private-protocol) 항목을 참고해 주세요.
  13. ## AX(Accessibility API)를 핵심으로 개발
  14. `kmsg`는 macOS의 공식 Accessibility API, 즉 AX를 핵심 자동화 계층으로
  15. 사용해 개발되었습니다. Swift에서 `ApplicationServices`와 `AXUIElement`를
  16. 직접 호출해 사용자가 보는 KakaoTalk 창, 채팅 목록, 메시지 영역, 입력창을
  17. 탐색하고 제어합니다. 키보드와 마우스 입력이 필요한 동작은 `CGEvent`를
  18. 사용합니다.
  19. ```text
  20. CLI / MCP
  21. → KakaoTalkApp
  22. → UIElement
  23. → AXUIElement
  24. → macOS용 KakaoTalk
  25. ```
  26. - [`UIElement`](Sources/kmsg/Accessibility/UIElement.swift)는 AX 속성 조회,
  27. 계층 탐색, 값 설정, 액션 실행을 Swift 인터페이스로 감쌉니다.
  28. - [`AXActionRunner`](Sources/kmsg/Accessibility/AXActionRunner.swift)는
  29. AX 액션과 `CGEvent` 기반 입력을 실행합니다.
  30. - [`AXPathCache`](Sources/kmsg/Accessibility/AXPathCache.swift)는 자주 쓰는
  31. UI 경로를 캐시하고, KakaoTalk UI가 바뀌어 경로가 유효하지 않으면 다시
  32. 탐색할 수 있게 합니다.
  33. 이 구조는 `kmsg` 자체가 KakaoTalk 서버나 비공개 LOCO 프로토콜에 직접
  34. 연결하지 않고, 사용자가 실제로 조작하는 앱 UI를 통해 동작한다는 뜻입니다.
  35. 따라서 설치한 `kmsg` 바이너리에 macOS 손쉬운 사용 권한이 필요하며,
  36. KakaoTalk UI 구조가 바뀌면 일부 탐색 경로가 영향을 받을 수 있습니다.
  37. 자세한 설계 배경과 제약은 [아키텍처 문서](ARCHITECTURE.md)를 참고하세요.
  38. ## 데모
  39. https://github.com/user-attachments/assets/c620b2e3-7106-40fa-86d1-ed847e3b1a6f
  40. ## 실사용 후기
  41. <a href="https://www.youtube.com/watch?v=_Pd1G33_R48&t=1020s"><img src="https://i.ytimg.com/vi/_Pd1G33_R48/maxresdefault.jpg" alt="실사용 후기: 헤르메스 에이전트 5개로 뉴스 큐레이션부터 주식 매매까지 자동화한 방법 전부 공개합니다" width="400" /></a>
  42. **Builder Josh:** [헤르메스 에이전트 5개로 뉴스 큐레이션부터 주식 매매까지 자동화한 방법 전부 공개합니다 (AI 엔지니어 샘 호트만님)](https://www.youtube.com/watch?v=_Pd1G33_R48&t=1020s) — 17:00부터 재생
  43. <a href="https://www.youtube.com/watch?v=xz5fA7OyvQ0"><img src="https://i.ytimg.com/vi/xz5fA7OyvQ0/maxresdefault.jpg" alt="실사용 후기: 나만의 Hermes 시스템 구축 방법" width="400" /></a>
  44. **샘 호트만:** [나만의 Hermes 시스템 구축 방법 (문제정의부터 구축까지, 해외 AI 인사이트 발굴하기)](https://www.youtube.com/watch?v=xz5fA7OyvQ0)
  45. ## 주요 기능
  46. - 채팅 목록을 조회하고 재사용 가능한 로컬 `chat_id`를 생성합니다.
  47. - 최근 메시지를 읽거나 새 메시지를 실시간으로 감시합니다.
  48. - 화면에 표시되는 KakaoTalk UI를 제어해 텍스트와 이미지를 전송합니다.
  49. - 구조화된 JSON을 `stdout`으로 출력하고 AX 추적 로그는 `stderr`로 분리합니다.
  50. - 읽기, 텍스트 전송, 이미지 전송 도구를 제공하는 native stdio MCP 서버를 실행합니다.
  51. - background-safe 읽기, 창 레이아웃, 복구 모드, self-healing AX path cache를 지원합니다.
  52. ## 요구사항
  53. - macOS 13 이상
  54. - [macOS용 KakaoTalk](https://apps.apple.com/kr/app/kakaotalk/id869223134?mt=12)
  55. - 설치된 `kmsg` 바이너리에 대한 손쉬운 사용 권한
  56. ## 설치
  57. Homebrew 설치를 권장합니다.
  58. ```bash
  59. brew install channprj/tap/kmsg
  60. ```
  61. 이미 설치했다면 다음 명령으로 업데이트합니다.
  62. ```bash
  63. kmsg update
  64. ```
  65. `kmsg update`는 필요하면 Homebrew를 설치하고, 포뮬러를 설치하거나 업그레이드한
  66. 뒤, 직접 설치한 바이너리를 Homebrew 명령으로 연결합니다.
  67. 직접 다운로드와 소스 빌드 방법은 [USAGE.md](USAGE.md#installation)를 참고하세요.
  68. ## 빠른 시작
  69. ```bash
  70. kmsg status
  71. kmsg chats
  72. kmsg read "채팅방 이름" --limit 20
  73. kmsg send "채팅방 이름" "안녕하세요" --dry-run
  74. ```
  75. `kmsg status`는 손쉬운 사용 권한을 요청하고, 필요하면 KakaoTalk을 실행한
  76. 뒤 로그인 상태를 확인합니다. 마지막 명령은 dry run이므로 실제 메시지를
  77. 전송하지 않습니다.
  78. ## 코딩 에이전트 스킬
  79. 저장소에 포함된 `kmsg` 스킬을 설치하면 Claude Code와 Codex가 채팅방을
  80. 구조화된 JSON으로 찾고, 안정적인 `chat_id`로 메시지를 읽고, 전송 전에
  81. dry-run을 수행하는 공통 워크플로우를 사용할 수 있습니다. 먼저 위의
  82. Homebrew 명령으로 `kmsg`를 설치한 다음 스킬을 전역 설치하세요.
  83. ```bash
  84. npx skills add channprj/kmsg --skill kmsg --agent claude-code codex -g -y
  85. ```
  86. 호출 방법은 에이전트마다 다음과 같습니다.
  87. | 에이전트 | 호출 |
  88. | --- | --- |
  89. | Claude Code | `/kmsg` |
  90. | Codex | `$kmsg` |
  91. ```text
  92. /kmsg 출시 준비 채팅방의 최근 메시지 10개를 요약해줘
  93. $kmsg 출시 준비 채팅방에 '배포 완료했습니다.'라고 보내줘
  94. ```
  95. 스킬은 텍스트 전송 전에 항상 dry-run으로 수신자와 내용을 확인합니다.
  96. 사용자가 명시적으로 전송을 요청한 경우에만 실제 `send`를 한 번 실행하며,
  97. 초안 작성이나 미리보기 요청은 전송하지 않습니다. `send-image`에는
  98. dry-run이 없으므로 명확한 수신자와 실제 이미지 전송 요청이 모두 있어야
  99. 실행합니다. 설치 후 스킬이 보이지 않으면 에이전트 세션을 다시 시작하세요.
  100. ## 자세한 문서
  101. - [사용법](USAGE.md) — 설치, 명령, 설정, 예제, 문제 해결
  102. - [아키텍처](ARCHITECTURE.md) — 구성 요소, 데이터 흐름, 상태, 설계 결정
  103. - [OpenClaw 연동](docs/openclaw.md) — MCP 및 실시간 watch 연동
  104. - [버전 관리](VERSIONING.md) — 릴리즈 형식과 자동화
  105. - [영문 README](README.en.md) — 이 문서의 영문 버전
  106. ## 자주 묻는 질문
  107. ### kmsg는 무엇인가요?
  108. `kmsg`는 macOS용 비공식 오픈소스 카카오톡 CLI이자 네이티브 MCP
  109. 서버입니다. 사용자, 스크립트, AI 에이전트가 명령줄에서 카카오톡
  110. 메시지를 읽고, 감시하고, 전송할 수 있게 해줍니다.
  111. ### kmsg는 카카오톡 공식 도구인가요?
  112. 아닙니다. `kmsg`는 Kakao Corp.와 제휴하거나 Kakao Corp.의 보증을 받은
  113. 도구가 아니며, 독립적으로 관리되는 오픈소스 프로젝트입니다.
  114. ### 어떤 운영체제를 지원하나요?
  115. `kmsg`는 macOS 13 이상과 macOS용 KakaoTalk을 필요로 합니다. Windows,
  116. Linux, Android, iOS는 지원하지 않습니다.
  117. ### kmsg는 카카오톡에 어떻게 접근하나요?
  118. Apple의 macOS 손쉬운 사용 API를 통해 화면에 표시되는 KakaoTalk
  119. 애플리케이션을 제어합니다. KakaoTalk의 비공개 LOCO 프로토콜은 구현하지
  120. 않습니다.
  121. ### MCP 서버가 포함되어 있나요?
  122. 네. 네이티브 `kmsg mcp-server` 명령은 MCP 호환 클라이언트와 AI
  123. 에이전트에 읽기, 텍스트 전송, 이미지 전송 도구를 stdio로 제공합니다.
  124. ### kmsg는 어떻게 설치하나요?
  125. `brew install channprj/tap/kmsg`를 실행해 Homebrew로 설치할 수 있습니다.
  126. 직접 다운로드와 소스 빌드 방법은 [사용법](USAGE.md)에서 확인할 수 있습니다.
  127. ## 영감
  128. 이 프로젝트는 [steipete](https://github.com/steipete)와 그의
  129. [imsg](https://github.com/steipete/imsg), 그리고
  130. [OpenClaw](https://github.com/openclaw/openclaw)에서 큰 영감을 받았습니다.
  131. ## 라이선스
  132. `kmsg`는 [MIT License](LICENSE)로 제공됩니다.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.