MCP 서버 관련 사항

이 모델 컨텍스트 프로토콜(MCP) 서버를 사용하면 Claude Desktop을 사용하여 Things 앱 의 작업 관리 데이터와 상호 작용할 수 있습니다. Claude에게 작업 생성, 프로젝트 분석, 우선순위 관리 등의 작업을 요청할 수 있습니다.

이 서버는 Things.py 라이브러리와 Things URL Scheme을 활용합니다.

특징

• 모든 주요 일정 목록(받은 편지함, 오늘, 예정된 일정 등)에 액세스할 수 있습니다.
• 프로젝트 및 지역 관리
• 태그 작업
• 고급 검색 기능
• 최근 항목 추적
• 체크리스트를 포함한 자세한 품목 정보
• 중첩된 데이터 지원(영역 내 프로젝트, 프로젝트 내 할 일)

설치(Claude Desktop용)

1. 필수 조건

• 파이썬 3.12+
• 클로드 데스크탑
• Things 3("Things URL 사용"은 설정 -> 일반에서 켜야 함)

2. 아직 uv를 설치하지 않았다면 설치하세요:

지엑스피1

그런 다음 터미널을 다시 시작하세요.

3. 이 저장소를 복제하세요:

4. 필요한 Python 패키지를 설치하세요.

5. Claude Desktop 구성 파일을 편집합니다.

구성 파일의 mcpServers 키에 Things 서버를 추가합니다(이러한 파일을 설치한 폴더의 경로를 업데이트해야 합니다).

Claude Desktop 앱을 다시 시작합니다.

Claude Desktop을 사용한 샘플 사용

• "오늘 내 할 일 목록에는 무엇이 있나요?"
• "다음 주 해변 휴가를 위해 짐을 싸야 할 일 목록을 만들고, 짐 싸기 체크리스트를 포함하세요."
• "아이젠하워 매트릭스를 사용하여 현재 할 일을 평가하세요."
• "Things를 사용하여 GTD 스타일의 주간 검토를 도와주세요."

팁

• Claude에서 Things을 사용하는 방법과 영역, 프로젝트, 태그 등을 구성하는 방법을 설명하는 사용자 지정 지침이 있는 프로젝트를 만듭니다. Claude가 새 작업을 만들 때 포함할 정보를 알려줍니다(예: 작업 설명에 관련 세부 정보를 포함하도록 요청하는 것이 도움이 될 수 있음).
• Claude가 캘린더에 접근할 수 있도록 다른 MCP 서버를 추가해 보세요. 이렇게 하면 Claude에게 특정 작업을 위해 캘린더에서 시간을 차단하거나, 예정된 캘린더 이벤트(예: 회의 준비)에서 할 일을 만드는 등의 작업을 할 수 있습니다.

사용 가능한 도구

목록 보기

• get-inbox - Inbox에서 할 일 가져오기
• get-today - 오늘 마감일인 할 일 가져오기
• get-upcoming - 예정된 할 일 가져오기
• get-anytime - Anytime 목록에서 할 일 가져오기
• get-someday - Someday 목록에서 할 일 가져오기
• get-logbook - 완료된 할 일 가져오기
• get-trash - 휴지통에 버린 할 일 목록 가져오기

기본 작업

• get-todos - 프로젝트별로 필터링하여 할 일 가져오기
• get-projects - 모든 프로젝트 가져오기
• get-areas - 모든 지역 가져오기

태그 작업

• get-tags - 모든 태그 가져오기
• get-tagged-items - 특정 태그가 있는 항목 가져오기

검색 작업

• search-todos - 제목/메모로 간단 검색
• search-advanced - 여러 필터를 사용한 고급 검색

시간 기반 작업

• get-recent - 최근에 생성된 항목 가져오기

도구 매개변수

할 일 목록

• project_uuid (선택 사항) - 프로젝트별로 할 일 필터링
• include_items (선택 사항, 기본값: true) - 체크리스트 항목 포함

get-projects / get-areas / get-tags

• include_items (선택 사항, 기본값: false) - 포함된 항목 포함

검색-고급

• status - 상태별 필터링(미완료/완료/취소)
• start_date - 시작일(YYYY-MM-DD)로 필터링
• deadline - 마감일(YYYY-MM-DD)로 필터링
• tag - 태그로 필터링
• area - 지역 UUID로 필터링
• type - 항목 유형(할 일/프로젝트/제목)으로 필터링

최근 게시물 가져오기

• period - 기간(예: '3일', '1주', '2개월', '1년')

문제 해결

서버에는 다음에 대한 오류 처리가 포함되어 있습니다.

• 잘못된 UUID
• 필수 매개변수가 없습니다
• 사물 데이터베이스 접근 오류
• 데이터 형식 오류

모든 오류는 기록되고 설명 메시지와 함께 반환됩니다. Claude Desktop에서 MCP 로그를 확인하려면 터미널에서 다음 명령어를 실행하세요.