Kakao Bot Mcp Server
@inspirit941
MCP Server Implementation on Kakao Developers API to connect an AI Agent
Overview
What is Kakao Bot MCP Server?
A Model Context Protocol (MCP) server implementation that integrates the Kakao Developers API to connect an AI Agent to a Kakao Official Account. It provides tools for sending Kakao Talk messages and managing Kakao TalkCalendar sub‑calendars. This is an example project and is not officially provided or maintained by Kakao.
How to use Kakao Bot MCP Server?
Create a Kakao application on developers.kakao.com, configure the required settings (platform, business app, Kakao Login, consent items), then clone the repository and set up a local environment with uv. All tools require the __email_address__ input to identify the user’s credentials.
Key features of Kakao Bot MCP Server
- Send Kakao Talk messages to yourself (text, feed, list, location, calendar, commerce templates)
- List, create, update, and delete sub‑calendars via TalkCalendar API
- Integrates with MCP‑compatible AI agents (e.g., Claude Desktop)
- Demonstrates usage of Kakao Developers API through an MCP server
Use cases of Kakao Bot MCP Server
- Send personalised Kakao Talk messages to yourself from an AI assistant
- Manage multiple sub‑calendars automatically through natural language commands
- Experiment with Kakao API integration in a conversational AI environment
FAQ from Kakao Bot MCP Server
Is this server officially provided by Kakao?
No. This repository is NOT officially provided or maintained by Kakao. It may not include complete functionality or comprehensive support.
What are the runtime requirements?
Python 3.13 or later, uv installed locally, and a Kakao account. A Kakao application with a business app (or individual developer business app) is also required.
Which Kakao API endpoints are supported?
For TalkMessage, only the “send to me – basic template” API is supported. For TalkCalendar, listing, creating, updating, and deleting sub‑calendars are supported.
Do I need additional permissions for the TalkCalendar API?
Yes. The TalkCalendar API requires a separate permission request to Kakao. See the Kakao Developer documentation for the request procedure.
Can individuals use this server?
Most Kakao APIs manage permissions based on business applications, so individual use is limited. A personal developer business app can be registered without a business registration number.