# KakaoTalk Message

> KakaoTalk Message is an open-source MCP server for communication. Lets an agent send KakaoTalk messages to yourself or friends, with approval for sends. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://appmonster.co.kr
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/kakao
- **MCP Registry name:** io.github.groove79/mcp-kakao
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/kakaotalk-message
