kmsg - 터미널에서 카카오톡 읽고 보내는 macOS CLI 도구

개발 중에 카카오톡 메시지를 확인하려고 매번 앱을 오가는 것이 번거로운 적 있으신가요? kmsg는 macOS 터미널에서 직접 카카오톡 메시지를 읽고, 보내고, 실시간 모니터링까지 할 수 있는 CLI 도구입니다. 단순한 메시지 전송을 넘어 MCP(Model Context Protocol) 서버까지 내장하고 있어, Claude Code 같은 AI 에이전트와 연결하면 카카오톡을 AI 워크플로우의 일부로 통합할 수 있습니다.

kmsg란?

kmsg는 macOS의 접근성(Accessibility) API를 활용하여 카카오톡 데스크탑 앱을 제어하는 CLI 도구입니다. imsg(iMessage CLI 도구)에서 영감을 받아 만들어졌으며, 대화 읽기, 메시지 발송, 이미지 전송, 실시간 모니터링을 터미널 한 곳에서 처리합니다.

설치 방법

Homebrew (권장)

brew install channprj/tap/kmsg

직접 다운로드

mkdir -p ~/.local/bin
curl -fL https://github.com/channprj/kmsg/releases/latest/download/kmsg-macos-universal -o ~/.local/bin/kmsg
chmod +x ~/.local/bin/kmsg

설치 확인

kmsg status

접근성 권한 설정 (필수)

1. 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용(Accessibility)
2. 터미널 앱(Terminal, iTerm2, WezTerm 등)을 추가

주요 명령어

유용한 옵션

• --json — 구조화된 JSON 출력 (자동화 파이프라인 연동용)
• --limit — 결과 수 제한 (기본값 20)
• --keep-window / -k — 열린 창 유지
• --deep-recovery — 실패 시 복구 모드
• --poll-interval — watch 모드 폴링 간격 (초)

MCP 서버로 AI 에이전트 연동

kmsg는 내장 MCP 서버를 통해 Claude Code 등 AI 도구와 연결할 수 있습니다. 이를 활용하면 카카오톡 메시지를 AI 워크플로우에 자연스럽게 통합할 수 있습니다.

Claude Code에서 설정하기

# MCP 서버 등록
claude mcp add kmsg --scope user -- kmsg mcp-server

• "홍길동에게 오늘 회의 안건 정리해서 보내줘"
• "팀방에서 오늘 온 메시지 요약해줘"
• "프로젝트 채팅방에 배포 완료 알림 보내줘"

실전 활용 시나리오

git push origin main && \
kmsg send "개발팀" "v2.1.0 배포 완료되었습니다. 확인 부탁드립니다."

kmsg watch "고객문의" --json --poll-interval 5 | \
jq -c 'select(.text | contains("긴급"))' | \
while read msg; do
  curl -X POST https://webhook.example.com/alert -d "$msg"
done

kmsg read "프로젝트A" --limit 100 --json > backup_$(date +%Y%m%d).json

제한사항

• macOS 전용 — Windows/Linux 미지원
• 카카오톡 데스크탑 앱 필수
• 비공식 도구 — 계정 제한 가능성 있음
• 접근성 권한 필요
• UI 변경 시 동작 깨질 수 있음

핵심 정리

• kmsg는 터미널에서 카카오톡을 제어하는 CLI 도구
• 간단한 설치로 바로 사용 가능
• MCP 서버로 AI 자동화까지 확장 가능
• JSON 출력 기반 자동화 파이프라인 구축 가능
• 비공식 도구이므로 주의 필요

참조 링크

• channprj/kmsg - GitHub공식 저장소 (소스 코드, README, 릴리스)
• Claude Code MCP 서버 문서MCP 서버 연결 및 설정 공식 가이드