Frequently Asked Questions (FAQ) about Kakao Bot MCP Server

Q: What is an MCP Server? A: MCP (Model Context Protocol) Server acts as a bridge, allowing AI models to access and interact with external data sources and tools, standardizing how applications provide context to LLMs.

Q: What Kakao APIs can I use with this MCP Server? A: Currently, the server supports Kakao Talk Message API (‘Send to Me’ - Basic Template) and Kakao Talk Calendar API (List Calendars, Create/Update/Delete Sub-Calendars).

Q: Do I need a business license to use the Kakao APIs? A: While some Kakao APIs require a business license, you can register as a “Personal Developer Business App” even without one for basic functionalities.

Q: How do I get permission to use the Kakao Talk Calendar API? A: You need to request permission from Kakao. You can find instructions at https://developers.kakao.com/docs/latest/ko/talkcalendar/common#policy-request-permission.

Q: What are the prerequisites for installing the Kakao Bot MCP Server? A: You need Python 3.13+ installed, a Kakao account, and the ‘uv’ package manager.

Q: What is the purpose of the .accounts.json file? A: The .accounts.json file stores the email address associated with your Kakao account, the account type (personal), and any extra information you want to pass to the MCP server.

Q: What is the purpose of the .kauth.json file? A: The .kauth.json file stores your Kakao application’s REST API key (client_id), client secret, and other authentication-related information.

Q: How does the server handle user authentication? A: The server uses OAuth 2.0 for authentication. If an access token is not found or is expired, it will prompt you to log in via a web browser.

Q: Where are the access token details stored after successful authentication? A: Access token information is stored in a file named .oauth2.<카카오메일주소>.json in the project root directory.

Q: What is UBOS and how does it relate to this MCP Server? A: UBOS is a full-stack AI Agent development platform that helps you orchestrate AI Agents, connect them with enterprise data, and build custom AI Agents. The Kakao Bot MCP Server is an asset available in the UBOS marketplace to help connect agents to Kakao services.

Q: What if my refresh token is also expired? A: If your refresh token is expired, the tool will return a URL that allows you to log in again and get a new access token.

Q: Why do the Kakao Talk Message API tools require my email address as an input? A: The email address (__email_address__) is required to identify the user’s credentials and ensure that the AI Agent is acting on behalf of the user with their explicit consent when interacting with the Kakao API.