macOS용 KakaoTalk CLI · MCP 서버

카카오톡을 AI Native 하게 사용하세요.

macOS 손쉬운 사용 API로 동작하는 비공식 CLI입니다. 로컬 자동화와 MCP 클라이언트에서 같은 명령을 사용합니다.

MIT 오픈소스내 Mac에서만 로컬 실행전송 전 dry-run 확인

메시지 워크플로우

세 명령으로 대화를 이어갑니다.

채팅방을 찾고, 맥락을 읽고, 터미널에서 바로 답장합니다.

01
채팅방 찾기
채팅 목록에서 대상과 재사용 가능한 chat_id를 찾습니다.
02
맥락 읽기
최근 메시지를 읽고 답장에 필요한 맥락을 확인합니다.
03
확인하고 전송
대상을 확인한 뒤 실제 KakaoTalk 창으로 답장합니다.

왜 kmsg인가

로컬 자동화에 필요한 것만 담았습니다.

AX
macOS에서 로컬로
화면에 표시되는 KakaoTalk을 손쉬운 사용 API로 제어합니다.
MCP
CLI와 네이티브 MCP
터미널, 스크립트, MCP 클라이언트에서 같은 기능을 사용합니다.
{}
구조화된 출력
JSON과 텍스트는 stdout으로, AX 진단은 stderr로 분리합니다.

코딩 에이전트

에이전트가 달라도, kmsg는 그대로.
OpenClaw, Hermes Agent, Claude Code, Codex에서 같은 CLI와 MCP 워크플로우를 사용합니다.

MCP로 에이전트 연결

OpenClaw, Hermes Agent와 모든 MCP 클라이언트에 kmsg 서버를 등록합니다.

kmsg mcp-server

Claude Code와 Codex에서는 Skill로

공통 Skill을 설치하고 /kmsg 또는 $kmsg로 호출합니다.

/kmsg 출시 준비 채팅방의 최근 메시지 10개를 요약해줘
OpenClawHermes AgentClaude CodeCodex

주요 기능

읽기부터 전송까지, 하나의 명령 체계로.

메시지 읽기
채팅을 찾고 재사용 가능한 chat_id와 최근 메시지를 가져옵니다.
채팅 목록 조회최근 메시지
kmsg read "AI 프로젝트" --limit 20 --json
새 메시지 감시
사용 중인 KakaoTalk 창을 방해하지 않으면서 새 메시지를 확인합니다.
실시간 이벤트JSON 스트림복구 모드
kmsg watch "AI 프로젝트" --json
안전하게 전송
실제 UI로 텍스트와 이미지를 보내며 dry-run으로 먼저 검증합니다.
텍스트 전송이미지 전송dry-run 확인
kmsg send "AI 프로젝트" "확인했어요." --dry-run

모든 대화를 명령 줄로. kmsg는 별도 서버 없이 macOS 에서 직접 실행됩니다.

실사용 후기

실제 자동화 워크플로우에서 널리 사용되고 있습니다

kmsg를 에이전트와 로컬 자동화에 연결한 사용 사례입니다.

자주 묻는 질문

kmsg를 시작하기 전에 알아둘 것.

설치, 지원 환경, 접근 방식과 MCP에 관한 핵심 답변입니다.

설치

Homebrew로 바로 시작하세요.
macOS 13 이상, macOS용 KakaoTalk, 손쉬운 사용 권한이 필요합니다.
  1. 01

    Homebrew로 kmsg 설치

  2. 02

    시스템 설정에서 손쉬운 사용 권한 허용

  3. 03

    dry-run으로 첫 전송 확인

brew install channprj/tap/kmsg
kmsg update

kmsg update는 필요하면 Homebrew를 설치하고, 포뮬러를 설치하거나 업그레이드한 뒤, 직접 설치한 바이너리를 Homebrew 명령으로 연결합니다.