kmsg는 macOS용 비공식 카카오톡 CLI이자 네이티브 MCP 서버입니다.
macOS 손쉬운 사용 API로 메시지를 읽고, 감시하고, 전송하며 로컬 자동화와
AI 에이전트를 위한 구조화된 출력을 제공합니다.
Disclaimer:
kmsg는 Kakao Corp. 의 공식 도구가 아닙니다. 사용자는 본인 계정/환경에서 관련 법규, 서비스 약관, 회사 보안 정책을 준수할 책임이 있습니다. 이 도구 사용으로 발생할 수 있는 계정 제한, 오작동, 데이터 손실, 기타 손해에 대한 책임은 사용자에게 있습니다. LOCO Protocol 이 아닌 AX 를 사용한 이유와 계정 제재 가능성에 대한 제 개인적인 판단은 왜 KakaoTalk 의 LOCO Protocol 을 사용하지 않나요? 항목을 참고해 주세요.
record.mp4
Builder Josh: 헤르메스 에이전트 5개로 뉴스 큐레이션부터 주식 매매까지 자동화한 방법 전부 공개합니다 (AI 엔지니어 샘 호트만님) — 17:00부터 재생
샘 호트만: 나만의 Hermes 시스템 구축 방법 (문제정의부터 구축까지, 해외 AI 인사이트 발굴하기)
- 채팅 목록을 조회하고 재사용 가능한 로컬
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-runkmsg status는 손쉬운 사용 권한을 요청하고, 필요하면 KakaoTalk을 실행한
뒤 로그인 상태를 확인합니다. 마지막 명령은 dry run이므로 실제 메시지를
전송하지 않습니다.
저장소에 포함된 kmsg 스킬을 설치하면 Claude Code와 Codex가 채팅방을
구조화된 JSON으로 찾고, 안정적인 chat_id로 메시지를 읽고, 전송 전에
dry-run을 수행하는 공통 워크플로우를 사용할 수 있습니다. 먼저 위의
Homebrew 명령으로 kmsg를 설치한 다음 스킬을 전역 설치하세요.
npx skills add channprj/kmsg --skill kmsg --agent claude-code codex -g -y호출 방법은 에이전트마다 다음과 같습니다.
| 에이전트 | 호출 |
|---|---|
| Claude Code | /kmsg |
| Codex | $kmsg |
/kmsg 출시 준비 채팅방의 최근 메시지 10개를 요약해줘
$kmsg 출시 준비 채팅방에 '배포 완료했습니다.'라고 보내줘
스킬은 텍스트 전송 전에 항상 dry-run으로 수신자와 내용을 확인합니다.
사용자가 명시적으로 전송을 요청한 경우에만 실제 send를 한 번 실행하며,
초안 작성이나 미리보기 요청은 전송하지 않습니다. send-image에는
dry-run이 없으므로 명확한 수신자와 실제 이미지 전송 요청이 모두 있어야
실행합니다. 설치 후 스킬이 보이지 않으면 에이전트 세션을 다시 시작하세요.
- 사용법 — 설치, 명령, 설정, 예제, 문제 해결
- 아키텍처 — 구성 요소, 데이터 흐름, 상태, 설계 결정
- OpenClaw 연동 — MCP 및 실시간 watch 연동
- 버전 관리 — 릴리즈 형식과 자동화
- 영문 README — 이 문서의 영문 버전
kmsg는 macOS용 비공식 오픈소스 카카오톡 CLI이자 네이티브 MCP
서버입니다. 사용자, 스크립트, AI 에이전트가 명령줄에서 카카오톡
메시지를 읽고, 감시하고, 전송할 수 있게 해줍니다.
아닙니다. kmsg는 Kakao Corp.와 제휴하거나 Kakao Corp.의 보증을 받은
도구가 아니며, 독립적으로 관리되는 오픈소스 프로젝트입니다.
kmsg는 macOS 13 이상과 macOS용 KakaoTalk을 필요로 합니다. Windows,
Linux, Android, iOS는 지원하지 않습니다.
Apple의 macOS 손쉬운 사용 API를 통해 화면에 표시되는 KakaoTalk 애플리케이션을 제어합니다. KakaoTalk의 비공개 LOCO 프로토콜은 구현하지 않습니다.
네. 네이티브 kmsg mcp-server 명령은 MCP 호환 클라이언트와 AI
에이전트에 읽기, 텍스트 전송, 이미지 전송 도구를 stdio로 제공합니다.
brew install channprj/tap/kmsg를 실행해 Homebrew로 설치할 수 있습니다.
직접 다운로드와 소스 빌드 방법은 사용법에서 확인할 수 있습니다.
이 프로젝트는 steipete와 그의 imsg, 그리고 OpenClaw에서 큰 영감을 받았습니다.
kmsg는 MIT License로 제공됩니다.