kmsg

Name: kmsg
Author: channprj

Verified

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

241stars

40forks

Swift

Installation

# Add to your Claude Code skills
git clone https://github.com/channprj/kmsg

Getting Started

Guides for using ai agents skills like kmsg.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 7/27/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-07-27T07:30:00.785Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is kmsg?

kmsg is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by channprj. Unofficial KakaoTalk CLI and native MCP server for macOS — read, watch, and send messages via Accessibility automation. It has 241 GitHub stars.

Is kmsg safe to use?

Yes. kmsg passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install kmsg?

Clone the repository with "git clone https://github.com/channprj/kmsg" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is kmsg written in?

kmsg is primarily written in Swift. It is open-source under channprj on GitHub, so you can review or fork the full source.

Are there alternatives to kmsg?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh kmsg against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

agent-browser-mcp agent-skills

kmsg — macOS용 카카오톡 CLI 및 MCP 서버

프로젝트 홈페이지 · English

kmsg는 macOS용 비공식 카카오톡 CLI이자 네이티브 MCP 서버입니다. macOS 손쉬운 사용 API로 메시지를 읽고, 감시하고, 전송하며 로컬 자동화와 AI 에이전트를 위한 구조화된 출력을 제공합니다.

Disclaimer: kmsg는 Kakao Corp. 의 공식 도구가 아닙니다. 사용자는 본인 계정/환경에서 관련 법규, 서비스 약관, 회사 보안 정책을 준수할 책임이 있습니다. 이 도구 사용으로 발생할 수 있는 계정 제한, 오작동, 데이터 손실, 기타 손해에 대한 책임은 사용자에게 있습니다. LOCO Protocol 이 아닌 AX 를 사용한 이유와 계정 제재 가능성에 대한 제 개인적인 판단은 왜 KakaoTalk 의 LOCO Protocol 을 사용하지 않나요? 항목을 참고해 주세요.

데모

https://github.com/user-attachments/assets/c620b2e3-7106-40fa-86d1-ed847e3b1a6f

실사용 후기

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-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로 제공됩니다.