README

quick-reminder-mcp

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

내부적으로 remindctl을 execFile로 호출합니다.

요구 사항

macOS
Node.js ≥ 18

remindctl:

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

설치 & 빌드

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에 추가:

{
  "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

quick-reminder-mcp

README

quick-reminder-mcp

요구 사항

설치 & 빌드

Claude Desktop 설정

도구

add_reminder

Quick Entry 사용 예시

라이선스

Recommended Servers

`add_reminder`