---
id: daily-kakaotalk-mac
name: "kakaotalk-mac"
url: https://skills.yangsir.net/skill/daily-kakaotalk-mac
author: nomadamas
domain: product
tags: ["automation", "productivity", "workflow"]
install_count: 2300
rating: 4.30 (20 reviews)
github: https://github.com/nomadamas/k-skill
---

# kakaotalk-mac

> 在 macOS 上通过本地数据库和辅助功能自动读取 KakaoTalk 消息，支持对话列表查看、消息搜索和自动回复

**Stats**: 2,300 installs · 4.3/5 (20 reviews)

## Before / After 对比

### 消息检索效率

**Before**:

手动打开 KakaoTalk 应用，逐个聊天窗口滚动查找历史消息，查找一周前的特定信息需要 5-10 分钟

**After**:

命令行直接搜索本地数据库，2 秒定位目标消息，支持关键词和时间范围筛选，无需打开应用

| Metric | Before | After | Change |
|---|---|---|---|
| 检索时间 | 300秒 | 2秒 | -99% |

## Readme

# kakaotalk-mac

# KakaoTalk Mac CLI

## What this skill does

`kakaocli` 를 사용해 macOS에서 카카오톡 대화 목록을 확인하고, 메시지를 검색하고, 필요할 때 답장을 보낸다.

이 스킬은 **macOS + 카카오톡 Mac 앱 설치**를 전제로 한다. 공식 Kakao API를 쓰는 것이 아니라 로컬 데이터베이스 읽기와 macOS 접근성 자동화 위에서 동작하므로, 권한과 안전 규칙을 먼저 확인해야 한다.

## When to use

- "카카오톡 최근 대화 목록 보여줘"

- "특정 채팅방 최근 메시지 찾아줘"

- "카카오톡 메시지 검색해줘"

- "내 카톡으로 테스트 메시지 보내줘"

- "답장 초안은 만들되 실제 전송 전에는 꼭 확인받아"

## When not to use

- macOS가 아닌 환경

- 카카오톡 Mac 앱이 설치되어 있지 않은 환경

- 사용자 확인 없이 다른 사람에게 메시지를 바로 보내야 하는 작업

- 카카오 공식 API 범위 안에서 해결 가능한 서버-투-서버 연동 작업

## Prerequisites

- macOS

- KakaoTalk for Mac 설치

- Homebrew

- Mac App Store 로그인(`mas` 사용 시)

- `kakaocli` 설치

- 터미널 앱에 **Full Disk Access** 와 **Accessibility** 권한 부여

## Inputs

- 채팅방 이름 또는 검색 키워드

- 읽기 범위: 최근 N개, `--since 1h`, `--since 7d` 등

- 전송할 메시지 본문

- 테스트 여부 (`--me`, `--dry-run`)

## Workflow

### 0. Install KakaoTalk for Mac first when missing

카카오톡 Mac 앱이 없으면 먼저 설치한다. `mas` 를 쓰려면 App Store 로그인 상태여야 한다.

```
brew install mas
mas account
mas install 869223134

```

`mas install` 이 막히면 App Store 앱에서 먼저 로그인한 뒤 다시 시도한다.

### 1. Install `kakaocli`

공식 저장소 기준 권장 설치는 Homebrew tap 이다.

```
brew install silver-flight-group/tap/kakaocli

```

설치 후 바로 상태를 확인한다.

```
kakaocli status

```

### 2. Grant the required macOS permissions

**System Settings > Privacy & Security** 에서 현재 사용하는 터미널 앱(iTerm, Terminal, Warp 등)에 아래 권한을 준다.

- **Full Disk Access**: 카카오톡 로컬 데이터베이스 읽기용

- **Accessibility**: 메시지 전송, harvest, inspect 같은 UI 자동화용

기본 규칙:

- `status` / `auth` / `chats` 같은 읽기 명령도 Full Disk Access 가 필요하다.

- `send`, `harvest`, `inspect` 류 작업은 Accessibility 권한까지 필요하다.

### 3. Verify read access before attempting side effects

먼저 읽기 경로가 되는지 확인한다.

```
kakaocli status
kakaocli auth
kakaocli chats --limit 10 --json

```

`auth` 가 성공하면 읽기 경로는 준비된 것이다.

### 4. Read or search messages

```
kakaocli messages --chat "지수" --since 1h --json
kakaocli search "점심" --json

```

응답은 가능하면 JSON 모드로 받고, 사람이 읽기 쉽게 다시 요약한다.

### 5. Use safe testing before real sends

실제 전송 전에 먼저 자기 자신에게 테스트하거나 dry-run 으로 확인한다.

```
kakaocli send --me _ "테스트 메시지"
kakaocli send --dry-run "채팅방 이름" "보낼 문장"

```

`--me` 는 나와의 채팅으로 보내므로 가장 안전한 테스트 경로다.

### 6. Confirm before sending to other people

다른 사람이나 단체방으로 보내기 전에는 반드시 사용자의 최종 확인을 받는다.

확인 전에는 아래만 준비한다.

- 대상 채팅방 이름

- 전송할 문장

- 왜 이 문장을 보내는지 한 줄 설명

확인을 받았을 때만 전송한다.

```
kakaocli send "채팅방 이름" "보낼 문장"

```

### 7. Use login storage only when the user explicitly wants auto-login

자동 로그인 편의를 원할 때만 자격증명을 저장한다.

```
kakaocli login
kakaocli login --status

```

비밀번호를 채팅창에 보내라고 요구하지 않는다. 사용자가 직접 로컬 터미널에서 입력하게 한다.

## Done when

- 읽기 요청이면 상태 확인 + 대화/메시지 조회 결과가 정리되어 있다

- 검색 요청이면 키워드 기준 결과가 정리되어 있다

- 전송 요청이면 테스트(`--me` 또는 `--dry-run`)와 사용자 확인이 끝난 뒤 실제 전송 여부가 명확하다

## Failure modes

- KakaoTalk for Mac 미설치

- App Store 로그인 누락으로 `mas install` 실패

- Full Disk Access 미부여

- Accessibility 미부여

- 채팅방 이름 substring 이 애매해서 잘못된 후보가 여러 개 잡힘

## Notes

- 이 스킬은 macOS 전용이다.

- 다른 사람에게 보내는 메시지는 항상 confirm before sending 원칙을 지킨다.

- 첫 검증은 `kakaocli status` 와 `kakaocli auth` 부터 시작하는 편이 안전하다.

Weekly Installs397Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars1.9KFirst Seen12 days agoSecurity Audits[Gen Agent Trust HubWarn](/nomadamas/k-skill/kakaotalk-mac/security/agent-trust-hub)[SocketWarn](/nomadamas/k-skill/kakaotalk-mac/security/socket)[SnykPass](/nomadamas/k-skill/kakaotalk-mac/security/snyk)Installed onantigravity394codex394opencode393deepagents393github-copilot393amp393

---
*Source: https://skills.yangsir.net/skill/daily-kakaotalk-mac*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-kakaotalk-mac/markdown*