Skip to content
MCP server

KakaoTalk Message

Lets an agent send KakaoTalk messages to yourself or friends, with approval for sends

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About KakaoTalk Message

KakaoTalk Message is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Alerts reach a phone fastest when they land in a chat app people already use. This server connects an agent to the Kakao Developers message API so it can post to your own chat or to friends who have also linked your Kakao app, and list those friends.

Setup takes about five minutes: create a Kakao app, enable Kakao Login with the talk_message consent item, and run a one-time browser login. Tokens are stored in a local file and refreshed automatically, or you can pass a refresh token through an environment variable for containers.

Sending tools never run blind. By default the first call returns a preview and a confirmation token and the agent re-calls only after you agree in chat. With an OK Agent key, the request goes to your phone for approval on KakaoTalk instead, and a direct mode turns the check off for trusted scripts. The README notes that business Alimtalk messages need a separate dealer contract and are not covered.

Install

Run in a terminal

claude mcp add mcp-kakao --env KAKAO_REST_API_KEY='<KAKAO_REST_API_KEY>' --env KAKAO_CLIENT_SECRET='<KAKAO_CLIENT_SECRET>' --env KAKAO_REFRESH_TOKEN='<KAKAO_REFRESH_TOKEN>' --env OKAGENT_API_KEY='<OKAGENT_API_KEY>' -- npx -y @appmonster/mcp-kakao

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-kakao": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kakao"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "<KAKAO_REST_API_KEY>",
        "KAKAO_CLIENT_SECRET": "<KAKAO_CLIENT_SECRET>",
        "KAKAO_REFRESH_TOKEN": "<KAKAO_REFRESH_TOKEN>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-kakao": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kakao"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "<KAKAO_REST_API_KEY>",
        "KAKAO_CLIENT_SECRET": "<KAKAO_CLIENT_SECRET>",
        "KAKAO_REFRESH_TOKEN": "<KAKAO_REFRESH_TOKEN>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-kakao": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kakao"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "<KAKAO_REST_API_KEY>",
        "KAKAO_CLIENT_SECRET": "<KAKAO_CLIENT_SECRET>",
        "KAKAO_REFRESH_TOKEN": "<KAKAO_REFRESH_TOKEN>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-kakao": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kakao"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "<KAKAO_REST_API_KEY>",
        "KAKAO_CLIENT_SECRET": "<KAKAO_CLIENT_SECRET>",
        "KAKAO_REFRESH_TOKEN": "<KAKAO_REFRESH_TOKEN>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-kakao": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kakao"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "<KAKAO_REST_API_KEY>",
        "KAKAO_CLIENT_SECRET": "<KAKAO_CLIENT_SECRET>",
        "KAKAO_REFRESH_TOKEN": "<KAKAO_REFRESH_TOKEN>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}

Configuration

  • KAKAO_REST_API_KEYKakao Developers app REST API keyRequired
  • KAKAO_CLIENT_SECRETClient secret, only if enabled in the app's Kakao Login settings
  • KAKAO_REFRESH_TOKENAlternative to the stored token file from `mcp-kakao auth`
  • OKAGENT_API_KEYOK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.
  • KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

kakao_me
Checks the connected account and its consent items.
kakao_send_to_me
Sends a text or feed card to your own chat; a write action.
kakao_list_friends
Lists friends who have connected the app.
kakao_send_to_friends
Sends to up to five friends by UUID with per-recipient results; a write action.

What it does

Message to self
Sends text or a feed card with links and buttons to your own chat.
Message to friends
Sends to up to five friend UUIDs per call with per-recipient results.
Friend list
Lists friends who have connected the app.
Write approval modes
Choose confirm-in-chat, phone approval through OK Agent, or direct sending.
Token auto-refresh
Stored OAuth tokens refresh automatically, or use an environment refresh token.
Error hints
The README maps common Kakao error codes to fixes.

Good for

  • Send yourself a notification when a long agent task finishes
  • Message a few friends with a link
  • Check which friends have linked your app
  • Require phone approval before an agent sends anything

Pricing

Open source

Free package; OK Agent approval key is free for 200 requests a month

Prices change. Check appmonster.co.kr before you buy.

KakaoTalk Message FAQ

What is the text limit?

Plain text messages are limited to 200 characters; a title or image URL makes a feed card, with at most two buttons.

Can it send to anyone?

Only to yourself or friends who also linked your app. Friend messaging has a daily send limit (error -532).

Does it support business Alimtalk?

No. That channel needs an official dealer contract and is listed as roadmap only.

Which credentials are required?

A Kakao Developers REST API key; a client secret is needed only if enabled in the app's login settings.

Is KakaoTalk Message free?

Yes. KakaoTalk Message is open source, so you can use and self-host it for free.

How do I add KakaoTalk Message to Claude Code?

Run this command in your terminal: claude mcp add mcp-kakao --env KAKAO_REST_API_KEY='<KAKAO_REST_API_KEY>' --env KAKAO_CLIENT_SECRET='<KAKAO_CLIENT_SECRET>' --env KAKAO_REFRESH_TOKEN='<KAKAO_REFRESH_TOKEN>' --env OKAGENT_API_KEY='<OKAGENT_API_KEY>' -- npx -y @appmonster/mcp-kakao

What are the best alternatives to KakaoTalk Message?

The closest alternatives to KakaoTalk Message are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to KakaoTalk Message

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity