MCP iCal 서버
🗓️ macOS용 자연어 캘린더 관리
🌟 개요
자연어를 사용하여 macOS 캘린더와의 상호 작용 방식을 혁신하세요! mcp-ical 서버는 모델 컨텍스트 프로토콜(MCP)을 활용하여 캘린더 관리를 대화형 환경으로 전환합니다.
지엑스피1
Related MCP server: Cal.com Calendar MCP Server
✨ 특징
📅 이벤트 생성
자연어를 즉시 일정 이벤트로 변환하세요!
지원되는 기능
사용자 정의 달력 선택
위치 및 참고사항
스마트 리마인더
반복되는 이벤트
전문 사용자 예
🔍 스마트 일정 관리 및 가용성
자연스러운 쿼리로 일정에 빠르게 접근하세요:
✏️ 지능형 이벤트 업데이트
이벤트를 자연스럽게 수정하세요:
업데이트 기능
시간 및 날짜 수정
캘린더 전송
위치 업데이트
추가 사항 참고
알림 조정
반복되는 패턴 변화
📊 캘린더 관리
사용 가능한 모든 캘린더 보기
스마트 캘린더 제안
iCloud로 구성 시 원활한 Google 캘린더 통합
💡 전문가 팁 : 사용자 지정 캘린더에서 이벤트를 생성할 수 있으므로, Google 캘린더를 iCloud 캘린더와 동기화했다면 이 MCP 서버를 사용하여 Google 캘린더에도 이벤트를 생성할 수 있습니다! 이벤트를 생성/업데이트할 때 Google 캘린더를 지정하기만 하면 됩니다.
🚀 빠른 시작
💡 참고 : 이 지침은 Claude for Desktop을 사용하여 MCP 서버를 설정하는 데 중점을 두고 있지만, 이 서버는 모든 MCP 호환 클라이언트와 함께 사용할 수 있습니다. 다양한 클라이언트 사용에 대한 자세한 내용은 MCP 설명서를 참조하세요.
필수 조건
캘린더 앱이 구성된 macOS
MCP 클라이언트 - 데스크톱용 Claude가 권장됩니다.
설치
이 MCP 서버는 모든 MCP 호환 클라이언트와 함께 사용할 수 있지만, 아래 지침은 데스크톱용 Claude와 함께 사용하기 위한 것입니다.
복제 및 설정
# Clone the repository git clone https://github.com/Omar-V2/mcp-ical.git cd mcp-ical # Install dependencies uv sync데스크톱용 Claude 구성
~/Library/Application\ Support/Claude/claude_desktop_config.json생성하거나 편집합니다.{ "mcpServers": { "mcp-ical": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical", "run", "mcp-ical" ] } } }캘린더 액세스를 위한 Claude 실행
⚠️ 중요 : 캘린더 권한을 제대로 요청하려면 Claude를 터미널에서 실행해야 합니다. Finder에서 직접 실행하면 권한 요청이 표시되지 않습니다.
터미널에서 다음 명령을 실행하세요.
/Applications/Claude.app/Contents/MacOS/Claude⚠️ 경고 : 수동으로 일정 접근 권한을 부여 할 수도 있지만, 이 경우 시스템 파일을 수정해야 하므로 관련 위험을 이해하는 경우에만 수행해야 합니다.
사용을 시작하세요!
Try: "What's my schedule looking like for next week?"
🔑 참고 : 캘린더 관련 명령을 처음 사용하면 macOS에서 캘린더 접근 권한을 묻는 메시지가 표시됩니다. 이 메시지는 위에서 설명한 대로 터미널에서 Claude를 실행한 경우에만 나타납니다.
🧪 테스트
⚠️ 경고 : 테스트는 임시 캘린더와 이벤트를 생성합니다. 정리는 자동으로 진행되지만, 개발 환경에서만 테스트를 실행하세요.
🐛 알려진 문제
반복되는 이벤트
비표준 반복 일정은 항상 올바르게 설정되지 않을 수 있습니다.
Haiku에 비해 Claude 3.5 Sonnet이 더 나은 결과를 보였습니다.
하루 종일 반복되는 이벤트에 대한 알림 시간은 하루 정도 차이가 있을 수 있습니다.
🤝 기여하기
피드백과 기여를 환영합니다. 참여 방법은 다음과 같습니다.
저장소를 포크하세요
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 열기
📝 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
🙏 감사의 말
모델 컨텍스트 프로토콜 로 구축됨
PyObjC 로 구축된 macOS 캘린더 통합