Kakao Bot
MCP Server Implementation on Kakao Developers API to connect an AI Agent
What is Kakao Bot?
Kakao Bot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server implementation on kakao developers api to connect an ai agent
MCP Server Implementation on Kakao Developers API to connect an AI Agent
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Server Implementation on Kakao Developers API to connect
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx kakao-botConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Kakao Bot
Kakao Bot MCP Server connects AI agents to the Kakao Developers API, enabling Claude and other MCP clients to send rich message templates — text, feed cards, lists, locations, calendar events, and commerce listings — directly to Kakao Talk, and to manage Kakao calendars on behalf of authenticated users. It implements the full Kakao Talk Message API (6 template types) and the Kakao Calendar API (4 operations) through an OAuth2 flow that securely stores and refreshes tokens locally. Korean developers building AI assistants on the Kakao platform use it to automate notifications, schedule creation, and conversational commerce workflows.
Prerequisites
- Python 3.13 or later
- uv package manager (pip install uv)
- A Kakao account and a registered application at developers.kakao.com
- Kakao Login enabled on your app with message transmission and email disclosure consent scopes
- REST API key and client secret from the Kakao Developers dashboard
Clone the repository and install dependencies
Clone the project, install uv if needed, then sync all Python dependencies.
git clone [email protected]:inspirit941/kakao-bot-mcp-server.git
cd kakao-bot-mcp-server
pip install uv
uv syncCreate the .accounts.json configuration file
In the project root, create .accounts.json mapping your Kakao email to an account type. All MCP tools require the __email_address__ parameter which must match an entry in this file.
{
"accounts": [
{
"email": "[email protected]",
"account_type": "personal",
"extra_info": "Primary Kakao account"
}
]
}Create the .kauth.json OAuth credentials file
In the project root, create .kauth.json with your app's OAuth credentials from the Kakao Developers console. Register http://localhost:8000/code as a redirect URI in your Kakao app settings.
{
"web": {
"client_id": "YOUR_REST_API_KEY",
"client_secret": "YOUR_CLIENT_SECRET",
"auth_uri": "https://kauth.kakao.com/oauth/authorize",
"token_uri": "https://kauth.kakao.com/oauth/token",
"redirect_uris": ["http://localhost:8000/code"],
"revoke_uri": "https://kapi.kakao.com/v2/user/revoke/scopes",
"token_info_uri": "https://kauth.kakao.com/oauth/tokeninfo"
}
}Run the server to complete OAuth authorization
Start the server for the first time. It will open a browser window with the Kakao OAuth2 login screen. Complete the login; the token is saved as .oauth2.<email>.json for automatic reuse.
uv run mcp-kakaoConfigure Claude Desktop
Add the server to claude_desktop_config.json. Replace your-project-path with the absolute path to the cloned repository.
{
"mcpServers": {
"mcp-kakao": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/kakao-bot-mcp-server",
"run",
"mcp-kakao"
]
}
}
}Kakao Bot Examples
Client configuration (Claude Desktop)
Full claude_desktop_config.json entry for the Kakao Bot MCP Server using uv to run the server.
{
"mcpServers": {
"mcp-kakao": {
"command": "uv",
"args": [
"--directory",
"/Users/yourname/kakao-bot-mcp-server",
"run",
"mcp-kakao"
]
}
}
}Prompts to try
Sample prompts that exercise Kakao message templates and calendar tools via Claude.
- "Send a text message to my Kakao account ([email protected]) with a summary of today's tasks."
- "Send a feed card to Kakao with the title 'Meeting Reminder', description '3pm standup', and link to our calendar."
- "List all calendars in my Kakao account."
- "Create a new Kakao sub-calendar called 'AI Projects'."
- "Send a location card to Kakao for the office at 123 Main St, Seoul."Troubleshooting Kakao Bot
OAuth2 browser window does not open on first run
Ensure http://localhost:8000/code is registered as a redirect URI in your Kakao application at developers.kakao.com under Platform > Web. If the browser does not open automatically, check the terminal output for the authorization URL and open it manually.
Tools return an 'email not found in accounts' error
Every tool call requires the __email_address__ parameter matching an entry in .accounts.json exactly. Ensure the email you provide in your prompt matches the email field in .accounts.json (case-sensitive).
Token expires and the server stops working
The server auto-refreshes tokens, but if the refresh token itself expires you must re-authenticate. Delete the .oauth2.<email>.json file in the project root and restart the server to trigger a new OAuth2 login flow.
Frequently Asked Questions about Kakao Bot
What is Kakao Bot?
Kakao Bot is a Model Context Protocol (MCP) server that mcp server implementation on kakao developers api to connect an ai agent It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Kakao Bot?
Follow the installation instructions on the Kakao Bot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Kakao Bot?
Kakao Bot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Kakao Bot free to use?
Yes, Kakao Bot is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Kakao Bot Alternatives — Similar Communication Servers
Looking for alternatives to Kakao Bot? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Kakao Bot in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Kakao Bot?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.