KakaoTalk Message
Lets an agent send KakaoTalk messages to yourself or friends, with approval for sends
- 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-kakaoAdd 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 keyRequiredKAKAO_CLIENT_SECRETClient secret, only if enabled in the app's Kakao Login settingsKAKAO_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

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity