본문 바로가기
M MCP모아

MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.

카카오톡 CLI·MCP 서버 (비공식, macOS) — macOS 카카오톡을 손쉬운 사용 API로 읽고 보내는 비공식 CLI·MCP

channprj/kmsg

macOS 카카오톡 앱을 손쉬운 사용 API로 제어해 AI 에이전트에 연결하는 비공식 MCP 서버

실험적 사용 주의 ⚖ MIT API 키 필요 ★ 288 업데이트 1개월 전
Claude Code Cursor Cline 호환

설치

터미널에서 실행하세요. 기본은 이 프로젝트 전용(local, ~/.claude.json)으로 저장됩니다. 팀과 공유하려면 --scope project(프로젝트 루트 .mcp.json), 모든 프로젝트에서 쓰려면 --scope user 를 붙이세요. 확인: claude mcp list 또는 Claude Code 세션 안에서 /mcp

claude mcp add -e KMSG_DEFAULT_DEEP_RECOVERY=false -e KMSG_TRACE_DEFAULT=false kmsg -- kmsg mcp-server

이 MCP가 해결하는 문제

카카오톡은 개인 메시지에 접근하는 공식 개발자 API를 제공하지 않아 AI 에이전트가 채팅방 대화를 읽거나 답장을 보내기 어렵습니다. kmsg는 macOS 손쉬운 사용 API로 이미 로그인된 카카오톡 앱 화면을 조작하는 방식으로 이 간극을 메웁니다. 채팅 목록 조회, 최근 메시지 읽기, 텍스트·이미지 전송을 MCP 도구로 제공하되, 비공식 도구이므로 약관과 계정 제재 가능성은 사용자가 감수해야 합니다.

보안 점검

2026-11-16 점검
사용 주의

비공식 AX 자동화로 카카오톡 대화를 읽고 보내며 손쉬운 사용 권한과 로컬 비밀번호 저장이 필요해, 약관·계정 제재 및 권한 범위 유의가 필요합니다.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 제3자 서버 경유 없음
  • 자격증명 평문 저장 없음

유의사항

  • 비공식 도구: 카카오 서버/LOCO 프로토콜 직접 연결은 없고 macOS 손쉬운 사용 API로 앱 UI를 조작. README가 계정 제한 가능성과 약관 준수 책임이 사용자에게 있음을 명시
  • 손쉬운 사용 권한 필요: 권한을 부여하면 해당 바이너리가 카카오톡 창의 모든 채팅 내용을 읽고 임의 채팅방에 전송 가능. kmsg_send 는 confirm 미지정 시 즉시 전송
  • 자격증명: 카카오톡 비밀번호를 AES-GCM 암호화해 ~/.config/kmsg/credentials.json 에 저장하고 키는 ~/.config/kmsg/credentials/primary.key 에 별도 파일(0600)로 보관. 암호문과 키가 같은 기기에 있음(문서 명시). 평문 저장은 아님
  • 소스 확인한 네트워크 호출은 update 명령의 Homebrew 설치 스크립트 다운로드뿐이며 메시지·자격증명 외부 전송 코드는 발견되지 않음
  • Process 실행: MCP 서버가 자기 자신의 kmsg 바이너리를 하위 프로세스로 호출, update 명령은 brew·sudo·bash 실행(사용자가 직접 실행할 때만 동작)
  • 채팅 내용·메시지 데이터는 MCP 클라이언트(사용 중인 LLM)로 전달되므로 민감 대화 노출에 유의

데이터·키 전송 대상

로컬 전용(카카오톡 앱 UI, 손쉬운 사용 API)raw.githubusercontent.com(kmsg update 실행 시 Homebrew 설치 스크립트)

GitHub 저장소 직접 점검 — README·매니페스트(package.json/pyproject)·서버 소스·설치 스크립트·패키지 레지스트리(npm/PyPI/JSR) 대조. 공개 소스 기준의 자동+수동 검토 의견이며 완전성·무오류를 보증하지 않습니다. 시점 이후 변경될 수 있습니다.

한국어 사용 예시

채팅방 최근 대화 요약

'출시 준비' 채팅방의 최근 메시지 20개를 읽고 결정 사항을 요약해줘

메시지 전송 전 확인

'프로젝트팀' 채팅방에 '배포 완료했습니다.'를 보내기 전에 수신자와 내용을 먼저 확인해줘

이미지 파일 전송

~/Desktop/report.png 이미지를 '디자인팀' 채팅방에 전송해줘

자주 묻는 질문

카카오톡 공식 도구인가요?

아닙니다. README는 Kakao Corp.와 무관한 독립 오픈소스 프로젝트이며, 약관·법규·회사 보안 정책 준수와 계정 제한 등 손해에 대한 책임이 사용자에게 있다고 명시합니다. LOCO 프로토콜 대신 AX를 쓴 이유는 저장소의 ARCHITECTURE.md에 설명되어 있습니다.

어떻게 설치하고 어떤 권한이 필요한가요?

brew install channprj/tap/kmsg 로 설치합니다. macOS 13 이상, macOS용 카카오톡, 그리고 kmsg 바이너리에 대한 손쉬운 사용 권한이 필요합니다. kmsg status 명령이 권한을 요청하고 로그인 상태를 확인합니다.

메시지와 자격증명은 어디에 저장되나요?

문서 기준으로 카카오 서버 대신 로컬 앱 UI를 조작하며, 카카오톡 비밀번호는 AES-GCM으로 암호화해 ~/.config/kmsg/ 아래 소유자 전용(0600) 파일에 저장합니다. 암호문과 키가 같은 기기에 있다는 점은 문서가 직접 밝히고 있습니다. MCP 서버나 watch처럼 터미널이 없는 실행은 저장된 자격증명에 의존합니다.

연동 API

카카오톡 (macOS 앱, 비공식 AX 자동화)

관련 MCP

네이버 검색 MCP 서버

isnow890/naver-search-mcp

실험적 보안 점검 통과

네이버 검색·데이터랩 API로 웹·뉴스·블로그 검색과 트렌드 분석 제공

카카오·네이버·토스 네이버 검색 API네이버 데이터랩 API 원클릭
★ 89 ↓ 663/주 4일 전
Claude Code Cursor Cline

네이버 메일 MCP 서버

chanmuzi/naver-mail-mcp

실험적 사용 주의

네이버 메일을 IMAP/SMTP로 검색·읽기·초안 작성·발송하는 MCP 서버

업무·협업툴 네이버 메일 IMAP (imap.naver.com)네이버 메일 SMTP (smtp.naver.com) 보통
★ 21 7개월 전
Claude Code Cursor Cline

네이웍스 MCP 서버

yjcho9317/nworks

실험적 사용 주의

LINE WORKS(NAVER WORKS) 전용 MCP 서버 — 메시지·캘린더·드라이브·메일·할일·게시판 26개 도구 제공

업무·협업툴 LINE WORKSNAVER WORKS 보통
★ 29 ↓ 159/주 3일 전
Claude Code Cursor Cline

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.

아직 후기가 없습니다. 첫 후기를 남겨주세요!