kmsg는 macOS용 비공식 카카오톡 CLI이자 네이티브 MCP 서버입니다.
macOS 손쉬운 사용 API로 메시지를 읽고, 감시하고, 전송하며 로컬 자동화와
AI 에이전트를 위한 구조화된 출력을 제공합니다.
Disclaimer:
kmsg는 Kakao Corp. 의 공식 도구가 아닙니다. 사용자는 본인 계정/환경에서 관련 법규, 서비스 약관, 회사 보안 정책을 준수할 책임이 있습니다. 이 도구 사용으로 발생할 수 있는 계정 제한, 오작동, 데이터 손실, 기타 손해에 대한 책임은 사용자에게 있습니다. LOCO Protocol 이 아닌 AX 를 사용한 이유와 계정 제재 가능성에 대한 제 개인적인 판단은 왜 KakaoTalk 의 LOCO Protocol 을 사용하지 않나요? 항목을 참고해 주세요.
데모
실사용 후기
Builder Josh: 헤르메스 에이전트 5개로 뉴스 큐레이션부터 주식 매매까지 자동화한 방법 전부 공개합니다 (AI 엔지니어 샘 호트만님) — 17:00부터 재생
주요 기능
- 채팅 목록을 조회하고 재사용 가능한 로컬
chat_id를 생성합니다. - 최근 메시지를 읽거나 새 메시지를 실시간으로 감시합니다.
- 화면에 표시되는 KakaoTalk UI를 제어해 텍스트와 이미지를 전송합니다.
- 구조화된 JSON을
stdout으로 출력하고 AX 추적 로그는stderr로 분리합니다. - 읽기, 텍스트 전송, 이미지 전송 도구를 제공하는 native stdio MCP 서버를 실행합니다.
- background-safe 읽기, 창 레이아웃, 복구 모드, self-healing AX path cache를 지원합니다.
요구사항
- macOS 13 이상
- macOS용 KakaoTalk
- 설치된
kmsg바이너리에 대한 손쉬운 사용 권한
설치
Homebrew 설치를 권장합니다.
brew install channprj/tap/kmsg
직접 다운로드와 소스 빌드 방법은 USAGE.md를 참고하세요.
빠른 시작
kmsg status
kmsg chats
kmsg read "채팅방 이름" --limit 20
kmsg send "채팅방 이름" "안녕하세요" --dry-run
kmsg status는 손쉬운 사용 권한을 요청하고, 필요하면 KakaoTalk을 실행한
뒤 로그인 상태를 확인합니다. 마지막 명령은 dry run이므로 실제 메시지를
전송하지 않습니다.
자세한 문서
- 사용법 — 설치, 명령, 설정, 예제, 문제 해결
- 아키텍처 — 구성 요소, 데이터 흐름, 상태, 설계 결정
- OpenClaw 연동 — MCP 및 실시간 watch 연동
- 버전 관리 — 릴리즈 형식과 자동화
- 영문 README — 이 문서의 영문 버전
자주 묻는 질문
kmsg는 무엇인가요?
kmsg는 macOS용 비공식 오픈소스 카카오톡 CLI이자 네이티브 MCP
서버입니다. 사용자, 스크립트, AI 에이전트가 명령줄에서 카카오톡
메시지를 읽고, 감시하고, 전송할 수 있게 해줍니다.
kmsg는 카카오톡 공식 도구인가요?
아닙니다. kmsg는 Kakao Corp.와 제휴하거나 Kakao Corp.의 보증을 받은
도구가 아니며, 독립적으로 관리되는 오픈소스 프로젝트입니다.
어떤 운영체제를 지원하나요?
kmsg는 macOS 13 이상과 macOS용 KakaoTalk을 필요로 합니다. Windows,
Linux, Android, iOS는 지원하지 않습니다.
kmsg는 카카오톡에 어떻게 접근하나요?
Apple의 macOS 손쉬운 사용 API를 통해 화면에 표시되는 KakaoTalk 애플리케이션을 제어합니다. KakaoTalk의 비공개 LOCO 프로토콜은 구현하지 않습니다.
MCP 서버가 포함되어 있나요?
네. 네이티브 kmsg mcp-server 명령은 MCP 호환 클라이언트와 AI
에이전트에 읽기, 텍스트 전송, 이미지 전송 도구를 stdio로 제공합니다.
kmsg는 어떻게 설치하나요?
brew install channprj/tap/kmsg를 실행해 Homebrew로 설치할 수 있습니다.
직접 다운로드와 소스 빌드 방법은 사용법에서 확인할 수 있습니다.
영감
이 프로젝트는 steipete와 그의 imsg, 그리고 OpenClaw에서 큰 영감을 받았습니다.
라이선스
kmsg는 MIT License로 제공됩니다.