# kmsg

> kmsg is an unofficial KakaoTalk CLI and native MCP server for macOS. It reads, watches, and sends messages through Apple's Accessibility API for local automation and AI agents.

Current version: 1.260819.1
Canonical website: https://channprj.github.io/kmsg/
Source repository: https://github.com/channprj/kmsg
License: MIT

Primary facts:

- Platform: macOS 13 or later
- Runtime dependency: KakaoTalk for macOS
- Implementation: Swift 6
- Interface: CLI, structured JSON, hooks, and native stdio MCP server
- Access method: macOS Accessibility API; kmsg does not implement the private LOCO protocol
- Install: `brew install channprj/tap/kmsg`
- Affiliation: Independent open source; not affiliated with Kakao Corp.

## When to use kmsg

- [Read and watch KakaoTalk with kmsg](https://channprj.github.io/kmsg/usage/index.md): Use kmsg when an agent or local automation needs to list chats, read recent messages, watch for new messages, or produce structured JSON on a Mac where KakaoTalk is installed.
- [Preview and send KakaoTalk messages with kmsg](https://channprj.github.io/kmsg/usage/index.md): Use kmsg for user-approved text or image sends through the visible KakaoTalk UI; preview the target and payload with `--dry-run` before a real send.
- [Use the kmsg MCP server](https://channprj.github.io/kmsg/mcp/index.md): Use the native stdio MCP server when Claude, ChatGPT, Codex, or another MCP client should call kmsg read and send tools locally.
- [Install the kmsg coding-agent Skill](https://channprj.github.io/kmsg/skill/index.md): Use the Skill when a coding agent needs a repeatable safety-first workflow for checking status, resolving chat identities, reading, and sending.

## Developer resources

- [kmsg developer portal](https://channprj.github.io/kmsg/developers/index.md): First-party integration map for CLI and JSON, authentication, MCP, events, HTTP API status, webhooks, source, and safety boundaries.
- [kmsg API and CLI reference](https://channprj.github.io/kmsg/usage/index.md): Command syntax, structured JSON output, environment variables, installation, troubleshooting, and local automation contracts.
- [kmsg authentication docs](https://channprj.github.io/kmsg/developers/index.md): KakaoTalk desktop login, encrypted local credential storage, lock-mode behavior, and the absence of hosted OAuth or bearer-token authentication.
- [kmsg MCP server](https://channprj.github.io/kmsg/mcp/index.md): Native stdio MCP transport, tool names, client configuration, confirmation behavior, and operating constraints.
- [kmsg webhooks and event integration status](https://channprj.github.io/kmsg/developers/index.md): Local `watch --json` events, the absence of a hosted webhook service, and the operator-owned supervisor pattern.

## Documentation

- [kmsg - macOS용 카카오톡 CLI 및 MCP 서버](https://channprj.github.io/kmsg/index.md): 터미널과 AI 코딩 에이전트에서 KakaoTalk 채팅을 찾고 읽고 안전하게 보내는 macOS용 오픈소스 CLI와 MCP 서버입니다.
- [kmsg — KakaoTalk CLI & MCP server for macOS](https://channprj.github.io/kmsg/en/index.md): Open source macOS CLI and MCP server for finding, reading, and safely sending KakaoTalk chats from terminals and AI coding agents.
- [kmsg — macOS向けKakaoTalk CLI / MCPサーバー](https://channprj.github.io/kmsg/jp/index.md): ターミナルやAIコーディングエージェントからKakaoTalkのチャットを検索、閲覧、安全に送信できるmacOS向けオープンソースCLI・MCPサーバーです。
- [kmsg — 面向macOS的KakaoTalk CLI与MCP服务器](https://channprj.github.io/kmsg/cn/index.md): 面向macOS的开源CLI和MCP服务器，可在终端与AI编程智能体中查找、读取并安全发送KakaoTalk聊天消息。
- [kmsg 사용법 — macOS에서 KakaoTalk 자동화하기](https://channprj.github.io/kmsg/usage/index.md): kmsg 설치, 전체 명령, JSON 출력, 안전한 읽기, KakaoTalk 자동화 문제 해결 방법을 안내합니다.
- [kmsg Usage — install and automate KakaoTalk on macOS](https://channprj.github.io/kmsg/en/usage/index.md): Install kmsg, learn every command, configure JSON output, and troubleshoot KakaoTalk Accessibility automation on macOS.
- [kmsgの使い方 — macOSでKakaoTalkを自動化](https://channprj.github.io/kmsg/jp/usage/index.md): インストール、主要コマンド、安全な読み取り、JSON、MCP、トラブルシューティングを説明します。
- [kmsg使用指南 — 在macOS上自动化KakaoTalk](https://channprj.github.io/kmsg/cn/usage/index.md): 介绍安装、主要命令、安全读取、JSON、MCP和故障排除。
- [kmsg 아키텍처 — macOS 손쉬운 사용 자동화](https://channprj.github.io/kmsg/architecture/index.md): Swift와 macOS 손쉬운 사용 API로 KakaoTalk을 자동화하는 구조와 설계 결정을 설명합니다.
- [kmsg Architecture — macOS Accessibility automation](https://channprj.github.io/kmsg/en/architecture/index.md): How kmsg uses Swift and the macOS Accessibility API to read, watch, and send KakaoTalk messages without implementing the private LOCO protocol.
- [kmsgアーキテクチャ — macOSアクセシビリティ自動化](https://channprj.github.io/kmsg/jp/architecture/index.md): SwiftとmacOSアクセシビリティAPIを使う構造、データフロー、設計判断を説明します。
- [kmsg架构 — macOS辅助功能自动化](https://channprj.github.io/kmsg/cn/architecture/index.md): 介绍基于Swift和macOS辅助功能API的组件、数据流与设计决策。
- [kmsg와 OpenClaw·MCP 클라이언트 연결하기](https://channprj.github.io/kmsg/mcp/index.md): 네이티브 kmsg MCP 서버, 실시간 감시, 승인 중심 전송 흐름을 구성합니다.
- [Connect kmsg to OpenClaw and MCP clients](https://channprj.github.io/kmsg/en/mcp/index.md): Configure the native kmsg MCP server and real-time watch mode for OpenClaw and other AI agent clients.
- [kmsgをOpenClawとMCPクライアントへ接続](https://channprj.github.io/kmsg/jp/mcp/index.md): ネイティブMCPサーバー、リアルタイム監視、承認付き送信フローを構成します。
- [将kmsg接入OpenClaw与MCP客户端](https://channprj.github.io/kmsg/cn/mcp/index.md): 配置原生MCP服务器、实时监控和带审批的发送流程。
- [kmsg 코딩 에이전트 Skill — Claude Code와 Codex에서 사용하기](https://channprj.github.io/kmsg/skill/index.md): Claude Code와 Codex에 kmsg Skill을 설치하고 KakaoTalk을 안전하게 탐색, 읽기, 전송하는 기본 절차를 안내합니다.
- [kmsg coding agent Skill — use KakaoTalk from Claude Code and Codex](https://channprj.github.io/kmsg/en/skill/index.md): Install the kmsg Skill for Claude Code and Codex, then follow a safe workflow to find, read, and send KakaoTalk messages.
- [kmsgコーディングエージェントSkill — Claude CodeとCodexで利用](https://channprj.github.io/kmsg/jp/skill/index.md): Claude CodeとCodexにkmsg Skillをインストールし、KakaoTalkを安全に探し、読み取り、送信する手順を説明します。
- [kmsg编程智能体Skill — 在Claude Code与Codex中使用](https://channprj.github.io/kmsg/cn/skill/index.md): 在Claude Code和Codex中安装kmsg Skill，并按照安全流程查找、读取和发送KakaoTalk消息。
- [kmsg 버전 관리와 릴리스 자동화](https://channprj.github.io/kmsg/versioning/index.md): 날짜 기반 버전 형식, 기준 파일, 릴리스 명령, 호환성 규칙을 설명합니다.
- [kmsg Versioning and release automation](https://channprj.github.io/kmsg/en/versioning/index.md): Understand the date-based kmsg version format, source of truth, release commands, and compatibility rules.
- [kmsgのバージョン管理とリリース自動化](https://channprj.github.io/kmsg/jp/versioning/index.md): 日付ベースの形式、正式な値、リリースコマンド、互換性を説明します。
- [kmsg版本管理与发布自动化](https://channprj.github.io/kmsg/cn/versioning/index.md): 介绍日期版本格式、唯一来源、发布命令和兼容性规则。
- [개인정보 처리 안내 - kmsg](https://channprj.github.io/kmsg/privacy/index.md): kmsg 정적 웹사이트의 데이터 처리와 외부 서비스 이용 범위를 안내합니다.
- [Privacy - kmsg](https://channprj.github.io/kmsg/en/privacy/index.md): How the static kmsg website handles data and links to external services.
- [プライバシー - kmsg](https://channprj.github.io/kmsg/jp/privacy/index.md): kmsgの静的ウェブサイトにおけるデータ処理と外部サービスの範囲を説明します。
- [隐私说明 - kmsg](https://channprj.github.io/kmsg/cn/privacy/index.md): 说明kmsg静态网站的数据处理方式与外部服务范围。
- [이용 조건 - kmsg](https://channprj.github.io/kmsg/terms/index.md): kmsg 웹사이트와 오픈소스 소프트웨어의 이용 조건을 안내합니다.
- [Terms - kmsg](https://channprj.github.io/kmsg/en/terms/index.md): Terms for the kmsg website and open source software.
- [利用条件 - kmsg](https://channprj.github.io/kmsg/jp/terms/index.md): kmsgのウェブサイトとオープンソースソフトウェアの利用条件を説明します。
- [使用条款 - kmsg](https://channprj.github.io/kmsg/cn/terms/index.md): 说明kmsg网站与开源软件的使用条款。
- [kmsg 소개 — 프로젝트, 운영 주체와 설계 원칙](https://channprj.github.io/kmsg/about/index.md): kmsg가 누구를 위해 만들어졌고 어떻게 운영되는지, 독립 오픈소스 프로젝트의 범위와 신뢰 근거를 설명합니다.
- [kmsg 연락처와 지원 안내](https://channprj.github.io/kmsg/contact/index.md): kmsg 버그 신고, 기능 제안, 보안·개인정보 문의에 사용할 공식 공개 채널과 안전한 문의 방법을 안내합니다.
- [kmsg 개발자 리소스 — CLI, JSON, 인증과 MCP 서버](https://channprj.github.io/kmsg/developers/index.md): kmsg CLI·구조화 JSON·로컬 인증·stdio MCP 서버의 개발자 문서와 지원 범위를 한곳에 정리합니다.
- [About kmsg — project identity and design principles](https://channprj.github.io/kmsg/en/about/index.md): Who kmsg is for, how the independent open source project is maintained, and which technical and trust boundaries apply.
- [Contact and support for kmsg](https://channprj.github.io/kmsg/en/contact/index.md): Official public channels for kmsg bug reports, feature requests, security concerns, and privacy questions.
- [kmsg developer resources — CLI, JSON, auth, and MCP](https://channprj.github.io/kmsg/en/developers/index.md): A predictable index for the kmsg CLI, structured JSON, local authentication, architecture, and native stdio MCP server.
- [kmsgについて — プロジェクトと設計原則](https://channprj.github.io/kmsg/jp/about/index.md): kmsgの目的、独立したオープンソース運営、技術的な範囲と信頼の根拠を説明します。
- [kmsgへの連絡とサポート](https://channprj.github.io/kmsg/jp/contact/index.md): バグ報告、機能提案、セキュリティおよびプライバシーに関する公式窓口を案内します。
- [kmsg開発者リソース — CLI、JSON、認証、MCP](https://channprj.github.io/kmsg/jp/developers/index.md): kmsgのCLI、構造化JSON、ローカル認証、アーキテクチャ、stdio MCPサーバーの索引です。
- [关于kmsg — 项目身份与设计原则](https://channprj.github.io/kmsg/cn/about/index.md): 说明kmsg的用途、独立开源项目的维护方式、技术边界与可信依据。
- [联系kmsg与获取支持](https://channprj.github.io/kmsg/cn/contact/index.md): 提供kmsg错误报告、功能建议、安全问题与隐私咨询的官方公开渠道。
- [kmsg开发者资源 — CLI、JSON、认证与MCP](https://channprj.github.io/kmsg/cn/developers/index.md): 集中提供kmsg CLI、结构化JSON、本地认证、架构以及stdio MCP服务器文档。

## Optional

- [Full Markdown corpus](https://channprj.github.io/kmsg/llms-full.txt): Project documentation combined as plain Markdown