Calendar Safe MCP

Apple Calendar용 비공식 로컬 MCP 서버입니다. Apple이 지원하는 캘린더 프레임워크인 EventKit을 사용하며, Calendar 데이터베이스, 계정 자격 증명 또는 macOS 권한 데이터베이스를 직접 읽지 않습니다.

macOS 14 Sonoma 이상 및 Python 3.12 이상이 필요합니다.

macOS 전용이며 다음 네 가지 도구를 제공합니다:

• list_calendars

• list_events

• create_event

• update_event

설치

uv를 설치한 후 MCP 클라이언트에 서버를 등록하세요. Codex의 경우:

codex mcp add calendar -- uvx --from git+https://github.com/jasongibby/calendar-safe-mcp calendar-safe-mcp

다른 stdio MCP 클라이언트의 경우 다음을 사용하세요:

{
  "mcpServers": {
    "calendar": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jasongibby/calendar-safe-mcp",
        "calendar-safe-mcp"
      ]
    }
  }
}

MCP 클라이언트를 시작한 후 list_calendars를 호출하세요. macOS가 해당 클라이언트에 Calendar 접근 권한을 요청합니다. System Settings → Privacy & Security → Calendars에서 전체 접근을 허용하세요.

Related MCP server: calendar-mcp

안전 및 개인정보 보호

• 접근은 Apple의 EventKit 프레임워크와 일반적인 macOS 동의 절차만 사용합니다.

• include_details=true가 전달되지 않는 한, 읽기는 일정 필드만 반환합니다.

• 생성 및 업데이트 응답은 간결하게 유지되며 메모, URL 또는 알람을 절대 포함하지 않습니다.

• 텍스트 검색은 search_notes=true가 전달되지 않는 한 제목만 검색합니다.

• 날짜 범위는 366일로 제한되며 응답 개수는 1,000개로 제한됩니다.

• 반복 일정 업데이트에는 this 또는 future를 명시하는 span이 필요합니다.

• 이벤트 내용은 서버에 절대 기록되지 않습니다.

• 삭제 및 반복 일정 생성 도구는 의도적으로 제외했습니다.

MCP 클라이언트와 AI 제공업체는 서버가 반환한 캘린더 데이터를 볼 수 있습니다. 사용 전에 해당 개인정보처리방침을 검토하세요. 이 프로젝트는 Apple과 제휴하지 않으며 Apple의 보증을 받지 않았습니다.

Apple의 EventKit 문서를 참조하세요.

개발

uv sync
uv run python -m unittest discover -s tests -v

테스트는 mock을 사용하며 Calendar 데이터에 접근하지 않습니다.

라이선스

MIT