# quick-reminder-mcp

Apple 미리 알림(Reminders) Quick Entry용 MCP 서버. Claude Desktop에서 자연어로 할 일을 말하면 즉시 Apple Reminders에 추가됩니다.

내부적으로 [`remindctl`](https://github.com/steipete/remindctl)을 `execFile`로 호출합니다.

## 요구 사항

- macOS
- Node.js ≥ 18
- [`remindctl`](https://github.com/steipete/remindctl):

  ```bash
  brew install steipete/tap/remindctl
  remindctl authorize   # 최초 1회, 미리 알림 접근 권한 허용
  ```

## 설치 & 빌드

```bash
git clone https://github.com/SeunghoHong/quick-reminder-mcp.git
cd quick-reminder-mcp
npm install
npm run build
```

빌드 결과는 `dist/index.js`에 생성됩니다.

## Claude Desktop 설정

`~/Library/Application Support/Claude/claude_desktop_config.json`에 추가:

```json
{
  "mcpServers": {
    "quick-reminder": {
      "command": "node",
      "args": ["/Users/raymond/Developer/quick-reminder-mcp/dist/index.js"]
    }
  }
}
```

경로는 본인 환경에 맞게 수정하세요. 설정 저장 후 Claude Desktop을 재시작합니다.

## 도구

### `add_reminder`

| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| `title` | string | ✅ | 할 일 제목 |
| `due_date` | string (ISO8601) | — | 마감 일시 (예: `2026-04-20T10:00:00+09:00`) |
| `list` | string | — | 리스트 이름 (기본값: `Work`) |
| `notes` | string | — | 메모 |

**응답 예시**

```
✅ 우유 사기 · 4/20 오전 10:00 · 할 일
```

실패 시:

```
❌ 실패: title이 비어 있습니다
```

## Quick Entry 사용 예시

Claude Desktop Option 2번 Quick Entry에서:

- "내일 오전 10시에 우유 사기 리마인더 추가해줘"
- "금요일까지 보고서 제출, 업무 리스트에"
- "30분 뒤에 세탁물 가져오기"

## 라이선스

MIT