ziesski/kakao-max

내 AI가 나를 대신해 대화하고, 답장하고, 일을 이어가도록.
카카오톡을 AI 에이전트에 연결하는 헤드리스 MCP 서버 .
데모 ·
사용 장면 ·
시작하기 ·
연결 구조 ·
권한 설계 ·
공개 현황 ·
FAQ ·
커뮤니티
Kakao Max 개발자 모임 참여하기 →
한국어로 나누는 MCP · AI 에이전트 · 자동화 개발 이야기
> [!WARNING]
> 비공식 프로젝트입니다. kakao-max는 Kakao의 공식 제품이 아니며 Kakao와 제휴하거나 승인을 받지 않았습니다.
> 카카오톡 프로토콜을 직접 구현해 내 계정으로 접속하므로, 계정 이용 제한 등 그 결과의 책임은 사용하는 사람에게 있습니다.
> 주로 쓰는 계정이 아닌 별도 계정으로 먼저 시험해 보세요. 받은 대화는 다른 사람의 개인정보이기도 합니다.
> [!NOTE]
> 초기 공개 버전입니다. 기능별로 실계정에서 확인한 범위(✅)와 단위 테스트만 거친 범위(🟡)를
> 기능 매트릭스에 나눠 적었습니다.
## AI에게, 카카오톡에서 일할 수 있는 손발을.
“내 대신 답장해 줘.” “가능한 시간을 확인해서 약속을 잡아 줘.” “작업이 끝나면 이 방에 알려 줘.”
kakao-max는 내 AI 에이전트가 카카오톡에서 대화의 맥락을 파악하고, 나를 대신해 답장하고, 다른 도구와 함께 일을 처리하도록 연결합니다. 대화를 복사해 AI에게 건네고 답변을 다시 붙여 넣던 흐름을, 에이전트가 직접 이어갈 수 있습니다.
카카오톡 PC 화면을 켜 두거나 클릭을 자동화할 필요 없이, GUI 없는 서버에서 카카오톡 기능을 MCP 도구로 제공합니다. 어떤 대화에 참여하고 어디까지 맡길지는 사용자가 정합니다.
## 짧은 데모로 보기
### AI가 대화를 읽고 요약 메시지 보내기
“개발자 모임 방의 대화를 요약해서 같은 방에 보내 줘.”
AI가 대화에서 최종 약속을 찾아 요약하고, 실제 카카오톡 대화방에 전송합니다. 왼쪽은 AI 에이전트, 오른쪽은 아이폰의 카카오톡 화면입니다.
MP4로 보기 · 12초 →
시연을 위해 작성한 예시 대화 · 실제 조회 및 전송 · 입력 4배속 / 처리 대기 8배속
이 시연에서는 여러 식사 후보와 시간 변경이 포함된 대화에서 최종 장소인 쌀국수집과 오후 1시 약속을 정리해 전송했습니다. 요약은 연결된 AI가 수행하고, kakao-max는 대화 조회와 메시지 전송 도구를 제공합니다.
이 영상은 대화 조회 → AI의 판단 → 카카오톡 전송이라는 기본 흐름을 보여 줍니다. 이 흐름에 내 일정, 업무 도구, 에이전트의 실행 규칙을 연결하면 답장과 일정 조율, 작업 결과 공유로 확장할 수 있습니다.
### Linux 터미널에서 카카오톡 주고받기
왼쪽은 SSH로 접속한 Linux에서 실행 중인 터미널 메신저, 오른쪽은 공식 카카오톡 PC 화면입니다. 터미널에서 보낸 메시지가 카카오톡에 도착하고, PC에서 보낸 답장은 터미널에 자동으로 표시됩니다.
MP4로 보기 · 10초 →
시연용 대화 · 실제 송수신 · 입력 2~3배속 / 도착 장면 정상 속도 / 마지막 화면 정지
이 시연은 사용자가 선택한 trust 모드에서 촬영했습니다. 새 메시지는 데몬의 이벤트 알림으로 갱신하며, 대기 중 반복 조회는 하지 않습니다. 조회·전송에는 기존 방 권한과 한도가 적용됩니다. ask 모드는 안읽은 방 제한을 유지합니다. 실행 방법과 모드별 동작은 터미널 메신저 안내에 정리했습니다.
## 카카오톡에서, 에이전트에게 맡길 일들
연결한 AI와 도구를 조합해 만들고 싶은 사용 장면입니다. 위 영상에서 확인한 범위는 대화 조회와 요약 메시지 전송이며, 아래 자동화 전체의 동작을 검증한 것은 아닙니다.
### 나를 대신해 답장
“이 방에서 내 도착 시간을 물으면 오후 7시쯤 도착한다고 답해 줘. 다른 질문은 나에게 먼저 물어봐.”
대화의 맥락과 내가 정한 조건에 맞춰 소통을 맡깁니다.
### 대화에서 일정 조율까지
“모임에서 나온 후보 시간과 내 캘린더를 비교해서, 가능한 시간을 방에 제안해 줘.”
카카오톡과 캘린더 도구를 연결해 대화 속 약속을 구체화합니다.
### 작업이 끝나면 대화로
“배포가 끝나면 결과를 개발자 방에 알려 줘. 실패하면 원인과 확인할 항목도 함께 보내 줘.”
다른 도구에서 수행한 일의 결과를 필요한 사람에게 전달합니다.
필요할 때 한 번 부탁하거나, 정해 둔 조건에 따라 계속 맡기거나. kakao-max는 그 작업 흐름의 카카오톡 연결을 담당합니다. 지속적인 자동 응답·예약·이벤트 감지는 연결한 에이전트와 실행 환경에서 구성하고, 캘린더·배포 같은 작업에는 해당 도구를 함께 연결합니다.
## 시작은 세 단계로
서버 하나 → 내 AI 연결 → 첫 요청과 권한 확인. 자세한 순서는 빠른 시작에 있습니다.
1. 내 Linux 서버에 설치합니다. Git으로 받은 체크아웃에서 마법사를 실행합니다.
bash
npm ci
npm run setup
새 Linux 서버 설치를 고르면 환경과 Git 버전을 확인하고, 전용 kakao-max 서비스 계정에 설치한 뒤
휴대폰 카카오톡 승인(또는 4자리 코드)으로 로그인합니다. 내용을 확인하고 승인하면 systemd 서비스로 등록·시작합니다.
Linux/systemd, Git, sudo, 시스템 경로에 설치된 Node(strip-types와 node:sqlite 지원, CI는 Node 22)가 필요합니다.
버전을 고정한 npm 패키지 설치도 있습니다. 새 서버에서 계정 입력 직전까지는 릴리스마다 자동 확인하지만, 로그인 이후는 아직 실제 서버에서 검증 전입니다.
2. 내 AI에 연결합니다. AI를 쓰는 컴퓨터에서 마법사의 기존 데몬 연결을 고르면 SSH로 서버의 데몬에 붙는
MCP 설정을 ~/.config/kakao-max/mcp.json에 만듭니다. mcpServers["kakao-max"] 항목을 AI 클라이언트에 등록하세요.
서버 코드와 카카오 자격증명은 AI 컴퓨터로 옮기지 않습니다.
AI를 쓰는 컴퓨터에는 패키지로 설치하면 됩니다. 셋 중 하나를 고르세요.
bash
npm install -g kakao-max # Node.js 22.18 이상
brew install ziesski/tap/kakao-max # macOS
scoop bucket add ziesski https://github.com/ziesski/scoop-bucket && scoop install ziesski/kakao-max # Windows
bash
kakao-max setup --config --ssh
Git 체크아웃에서는 npm run --silent setup -- --config --ssh 로 같은 설정을 만듭니다.