kmsg

KakaoTalk CLI · MCP server for macOS

KakaoTalk, from your terminal.

An unofficial CLI built on the macOS Accessibility API. Use the same commands in local automation and MCP clients.

InstallUsage
MIT open sourceRuns locally on your MacDry-run before every send

Message workflow

One thread, three commands.

Find the room, read its context, and reply without leaving the terminal.

01
Find the chat
Locate the target and its reusable chat_id from the chat list.
02
Read the context
Read recent messages and confirm the context needed for a reply.
03
Confirm and send
Confirm the target, then reply through the visible KakaoTalk window.

Why kmsg

Only what local automation needs.

AX
Local on macOS
Controls the visible KakaoTalk app through the Accessibility API.
MCP
CLI and native MCP
Use the same capabilities from terminals, scripts, and MCP clients.
{}
Structured output
JSON and text go to stdout while AX diagnostics stay on stderr.

Coding agents

One kmsg workflow, across your agents.
Use the same CLI and MCP workflow in OpenClaw, Hermes Agent, Claude Code, and Codex.

Connect agents through MCP

Register the kmsg server in OpenClaw, Hermes Agent, or any MCP client.

kmsg mcp-server

Use a Skill in Claude Code and Codex

Install the shared Skill, then start with /kmsg or $kmsg.

/kmsg Summarize the 10 latest messages in Release Prep
OpenClawHermes AgentClaude CodeCodex

Core capabilities

One command model, from reading to sending.

Read messages
Find chats and return stable chat IDs with recent messages.
Chat discoveryRecent messages
kmsg read "AI Project" --limit 20 --json
Watch new messages
Stream new messages without taking over the active KakaoTalk window.
Live eventsJSON streamRecovery mode
kmsg watch "AI Project" --json
Send safely
Send text and images through the visible UI, with dry-run first.
TextImagesDry-run confirmation
kmsg send "AI Project" "Checked." --dry-run

Every chat, one command away. kmsg runs directly on your Mac, with no separate server.

In use

Used in real automation workflows.

Examples of kmsg connected to agents and local automation.

Builder Josh

How five Hermes agents automate news curation and stock trading

Sam Hottman

How to build your own Hermes system
See more examples

Frequently asked questions

What to know before using kmsg.

Concise answers about setup, support, access, and MCP.

Install

Start with Homebrew.
Requires macOS 13+, KakaoTalk for macOS, and Accessibility permission.
  1. 01

    Install kmsg with Homebrew

  2. 02

    Grant Accessibility permission in System Settings

  3. 03

    Confirm your first send with dry-run

brew install channprj/tap/kmsg
kmsg update

kmsg update installs Homebrew when it is missing, installs or upgrades the formula, and links a directly installed binary to the Homebrew-managed command.

Latest release