OK Agent

카카오톡 MCP 서버 — AI가 카톡 메시지 보내기

카카오 디벨로퍼스 메시지 API를 MCP로 연결해, AI 에이전트가 나와의 채팅으로 요약·알림을 보내거나 친구에게 메시지를 보낼 수 있게 해 주는 무료 오픈소스 서버입니다.

@appmonster/mcp-kakao무료 · MIT 오픈소스GitHub →

무엇을 할 수 있나

도구하는 일
kakao_me연결된 내 계정 정보
kakao_send_to_me나와의 채팅으로 메시지 보내기결재 필요
kakao_list_friends메시지 보낼 수 있는 친구 목록
kakao_send_to_friends친구에게 메시지 보내기결재 필요

설치 (1분)

Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.

Claude Desktop · Cursor · Windsurf

MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.

{
  "mcpServers": {
    "kakao": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kakao"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "…"
      }
    }
  }
}

Claude Code

claude mcp add kakao -e KAKAO_REST_API_KEY=… -- npx -y @appmonster/mcp-kakao

필요한 키와 발급처

필수
KAKAO_REST_API_KEY — 카카오 앱 REST API 키
선택
KAKAO_CLIENT_SECRET — 보안 설정 시 Client Secret
선택
KAKAO_REFRESH_TOKEN — 선택: auth 명령 대신 직접 넣는 리프레시 토큰

발급: 카카오 디벨로퍼스. 앱을 만들고 카카오 로그인·'카카오톡 메시지 전송' 동의항목을 켠 뒤, `KAKAO_REST_API_KEY=… npx @appmonster/mcp-kakao auth`로 한 번 로그인합니다.

이렇게 시켜 보세요

쓰기 작업은 사람이 결재합니다

나와의 채팅으로 메시지 보내기, 친구에게 메시지 보내기은(는) 되돌리기 어려운 작업이라 바로 실행되지 않습니다. 기본으로는 바뀔 내용을 먼저 보여주고 대화창에서 확인을 받습니다. 설정에 OKAGENT_API_KEY를 넣으면 승인 요청이 휴대폰 카카오톡으로 와서, 자리를 비워도 탭 한 번으로 승인하거나 거부할 수 있고 기록도 남습니다.

카카오로 무료 시작OK Agent 알아보기월 200건 무료 · 카드 등록 없음

자주 묻는 질문

단체 발송(마케팅)도 되나요?

아니요. 개인 카카오 계정의 메시지 API라 나와의 채팅과 동의한 친구에게 보내는 용도입니다. 고객 대상 발송은 팝빌 알림톡 서버를 쓰세요.

-402 오류가 나요.

동의항목이 부족하다는 뜻입니다. 카카오 디벨로퍼스에서 '카카오톡 메시지 전송' 동의항목을 켜고 auth를 다시 실행하세요.

보내기 전에 확인할 수 있나요?

메시지 발송은 쓰기 도구라 보낼 내용을 먼저 보여주고 확인을 받습니다.

함께 쓰면 좋은 서버