kakao-bot

This MCP server integrates the Kakao Developers API with an AI Agent to enable sending Kakao Talk messages from the agent. It exposes a set of Kakao TalkMessage API-based tools that let the agent dispatch text, feed, list, location, calendar, and commerce templates to the authenticated Kakao account. Tools require the user’s credentials (typically an email associated with the Kakao account) or a configured Kakao business context, and each tool enforces its input schema as described in the README. Once running, the MCP server can be queried by the MCP framework to perform messaging tasks on behalf of the agent, enabling interactive conversations and notifications via Kakao Talk. Available tools include send_text_template_to_me, send_feed_template_to_me, send_list_template_to_me, send_location_template_to_me, send_calendar_template_to_me, and send_commerce_template_to_me, each with their respective inputs and optional fields for links, images, and action buttons.

Prerequisites:

• Node.js (v14+ recommended) and npm/yarn
• Access to Kakao Developers API with a registered app and appropriate permissions

Step 1: Clone the repository

git clone https://github.com/your-org/kakao-bot-mcp-server.git
cd kakao-bot-mcp-server

Step 2: Install dependencies

npm install
# or
yarn install

Step 3: Configure environment

• Create a .env file or export environment variables as shown below

KAKAO_API_KEY=your_kakao_api_key_here
KAKAO_ADMIN_KEY=your_kakao_admin_key_here
KAKAO_BOT_ID=your_kakao_bot_id_here
NODE_ENV=production

Step 4: Run the server

npm start
# or
node index.js

Step 5: Verify MCP integration

• Ensure the MCP host points to the running server and that the server exposes the expected endpoints for the MCP protocol. Test a few tool invocations (e.g., send_text_template_to_me) with sample inputs to validate authentication and message delivery.

Tips and common issues:

• Make sure Kakao API keys are correctly configured and have the required permissions for message templates.
• If you encounter rate limits or permission errors, check Kakao's app settings and ensure the account is properly provisioned for the messaging templates you use.
• Store sensitive keys securely (avoid committing .env). Use a secret manager in production.
• The MCP tool inputs expect the email_address field to identify the Kakao account; ensure this aligns with your Kakao Developer account linkage.
• If the server fails to start, verify Node.js compatibility, port availability, and that required dependencies are installed.
• When upgrading, re-check environment variable names and any API version changes in Kakao's documentation.