MCP Apple 알림

macOS에서 Apple Reminders와 상호작용하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

• 목록 관리 : Apple Reminders 앱에서 모든 알림 목록을 확인하세요.

• 알림 검색 : 특정 목록에서 모든 알림을 가져옵니다.

• 알림 만들기 : 제목, 마감일, 메모를 포함한 새 알림을 만듭니다.

• 완료 알림 : 알림을 완료로 표시

• 알림 삭제 : 목록에서 알림을 제거합니다.

• 날짜 처리 : 마감일을 위한 ISO 날짜 형식의 적절한 처리

Related MCP server: MCP Apple Calendars

구성

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

지엑스피1

NPX (곧 출시)

{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-apple-reminders"
      ]
    }
  }
}

API

서버는 Apple Reminders와 상호 작용하기 위한 다음 MCP 도구를 제공합니다.

getLists

모든 알림 목록을 반환합니다.

미리알림 받기

특정 목록에서 알림을 반환합니다.

• 매개변수:

  • listName (필수): 알림 목록의 이름

알림 생성

새로운 알림을 만듭니다.

• 매개변수:

  • listName (필수): 알림 목록의 이름

  • title (필수): 알림의 제목

  • dueDate (선택 사항): 알림의 마감일(ISO 형식: "YYYY-MM-DDTHH:MM:SS.sssZ")

  • notes (선택 사항): 알림에 대한 메모

완료 알림

알림을 완료된 것으로 표시합니다.

• 매개변수:

  • listName (필수): 알림 목록의 이름

  • reminderName (필수): 완료할 알림의 이름

알림 삭제

알림을 삭제합니다.

• 매개변수:

  • listName (필수): 알림 목록의 이름

  • reminderName (필수): 삭제할 알림의 이름

작동 원리

이 MCP 서버는 AppleScript를 사용하여 macOS의 Apple 미리 알림 앱과 상호 작용합니다. AI 비서가 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 미리 알림을 관리할 수 있는 표준화된 인터페이스를 제공합니다.

개발

이 프로젝트는 TypeScript와 MCP SDK를 사용합니다. 기능을 확장하려면 src/index.ts 의 도구와 src/reminders.ts 의 AppleScript 함수를 수정하세요.

요구 사항

• macOS(Apple Reminders 통합에 필요)

• 노드.js 16+

• 최소한 하나의 목록으로 구성된 Apple Reminders 앱

특허

MIT