KakaoTalk Message

@appmonster/mcp-kakao

Kakao Developers メッセージ API を介して KakaoTalk メッセージを送信する MCP サーバーです。エージェントは、接続したアカウントの自分とのチャット（나와의 채팅）や、アプリを連携済みの友だちにメッセージを送信したり、友だち一覧を取得したりできます。書き込み操作には人間による承認を必須にできます（OK Agent）。

KakaoTalk メッセージ用 MCP サーバー — 自分への送信／友だちへの送信／友だち一覧。アプリをインストールせずに社長のスマートフォンへ通知を届ける、最短の方法です。

アラートトーク（ビジネスメッセージ）は、Kakao の公式ディーラーとの契約が必要な別のチャネルです。このパッケージでは、個人や小規模事業者がすぐに利用できる Kakao Developers メッセージ API のみを扱います。アラートトークはロードマップに含まれています。

ツール

ツール	アクセス	内容
kakao_me	読み取り	接続済みアカウントと同意項目を確認（接続チェック用）
kakao_send_to_me	書き込み	自分とのチャットにテキスト／フィードカードを送信（リンク・ボタンを含む）
kakao_list_friends	読み取り	アプリを連携済みの友だち一覧（uuid）
kakao_send_to_friends	書き込み	最大5人の友だちの uuid に送信し、件ごとに成功／失敗を表示

セットアップ（5分、初回のみ）

1. https://developers.kakao.com → マイアプリ → アプリを追加します。アプリキー > REST API キーをコピーします。
2. プラットフォーム > Web：メッセージのリンクに使うドメインを登録します（例：https://okagent.kr）。
3. Kakao ログイン > 有効化 ONにし、Redirect URI に http://localhost:8788/callback を追加します。
4. Kakao ログイン > 同意項目：KakaoTalk メッセージ送信 (talk_message) を「選択同意」に設定します。友だち機能も使う場合は、KakaoTalk ソーシャル > 友だち一覧の権限を申請し、friends の同意項目を追加します。
5. ブラウザーで1回ログインします。

KAKAO_REST_API_KEY=… npx @appmonster/mcp-kakao auth

トークンは ~/.config/kmcp/kakao/<app>.json に保存され、自動で更新されます（refresh ≈ 2か月）。

6. MCP クライアントの設定：

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

コンテナーなどでファイルの保存が難しい場合は、KAKAO_REFRESH_TOKEN を env として渡します。アプリで Client Secret を有効にしている場合は、KAKAO_CLIENT_SECRET も渡します。

送信時の人間による承認（任意）

"OKAGENT_API_KEY": "ok_…"

この設定がなくても、書き込みツールが無確認で実行されることはありません。最初の呼び出しではプレビューと confirm_token が返され、チャットで同意した後にのみ、エージェントが再度呼び出します。OK Agent のキー（無料、月200回まで）があれば、リクエストが代わりにスマートフォンへ届きます。KakaoTalk で承認でき、ログも記録されます。完全に信頼できるスクリプトでは、KMCP_WRITE_MODE=direct に設定するとこのチェックを無効にできます。

メッセージ仕様

text（最大200文字）のみを指定するとテキストメッセージになり、title または imageUrl を指定するとフィードカードになります。ボタンを開くには、url がアプリの Web プラットフォームに登録されたドメインである必要があります。ボタンは最大2個です。

制限

• 自分への送信は審査なしですぐに実行できます。友だちへの送信では、相手もアプリを連携済みである必要があり、1日の送信上限があります（エラー -532）。
• エラーコードのヒント：-3 機能が有効になっていない、-401 トークンの期限切れ（auth を再実行）、-402 同意項目が不足しています。

開発

pnpm --filter @appmonster/mcp-kakao test