kakao-read

Reads local KakaoTalk messages, photos, and files offline on Mac and Windows.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill kakao-read-hivgb1-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kakao-read
Source: https://github.com/hivgb1-ai/do-better-workspace-v2/tree/main/.claude/skills/kakao-read
Command: npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill kakao-read-hivgb1-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sqlcipher, procdump, and includes scripts (resource) and references (resource) components.

What problem does it solve? Your KakaoTalk conversations hold appointments, tasks, and business inquiries, but they stay locked inside the app. This Skill reads your own KakaoTalk data directly from your local device—no server login, no screen capture—so an AI assistant can summarize chats, extract to-dos, search history, and inspect photos and files on demand. ## Core Features & Use Cases - Offline local reading on Mac: Decrypts the local SQLCipher database using your device UUID and account userId (auto-recovered via plist SHA-512 hash reversal on KakaoTalk 26.x), with zero server connections for text. - Windows memory-dump reading: Parses decrypted SQLite pages from the running KakaoTalk process memory via procdump, merging each snapshot into a cumulative store.db so captured rooms never disappear. - Media and file inspection: Downloads recent photos and files via Kakao CDN signed URLs so the AI can read image text and file contents. - Kakao check workflow: Lists 1:1 and small-group rooms with new activity since your last check, drops work signals into the inbox as raw files, and hands routing to inbox-triage. - Use Case: Say "카톡 체크" in the morning—the Skill lists rooms with new messages since yesterday, you pick which to read, and meeting requests or tasks are filed into your inbox for triage. ## Quick Start Ask the AI to read your recent KakaoTalk conversations, for example: "카톡 체크해줘" or "어제 그 방 대화 정리해줘".

Frequently Asked Questions about kakao-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read my KakaoTalk messages offline on Mac?

Run the kakao_read.py script after a one-time setup that recovers your userId. It derives the SQLCipher key from your device UUID and userId via PBKDF2, then queries the local NTChatMessage tables directly with zero server connections.

How to read KakaoTalk messages on Windows without the encryption key?

Use the kakao_win.py sync command, which dumps the running KakaoTalk process memory with procdump and parses decrypted SQLite pages directly. Results merge into a cumulative store.db so previously captured rooms persist across dumps.

Does reading KakaoTalk locally require sending my data to a server?

No. Text reading is fully offline from the local encrypted database. Only media downloads use a one-time Kakao CDN signed URL GET request, which is a plain file fetch with no login session or LOCO protocol involvement.

Why does KakaoTalk 26.x setup take longer than older versions?

Version 26.x removed the plain userId from the cache, so the script brute-forces a SHA-512 hash of the userId found in plist key names. This takes seconds to minutes depending on userId length, versus instant header extraction on 25.x.

What are the limitations of Windows KakaoTalk memory reading?

Only conversations loaded into memory at dump time are captured, so rooms never opened in KakaoTalk are missing. Room labels come from participant names rather than actual room names, and photo or file content inspection is unsupported.

Can this tool send KakaoTalk messages or read other people's accounts?

No. It is strictly read-only and limited to your own account on your own device. Sending messages, LOCO login, and accessing other devices are explicitly out of scope because they risk session conflicts and account bans.