hald/things-mcp

해결하는 문제

macOS에서 Things 3를 사용하여 작업을 관리하는 경우, 할 일 앱과 AI 어시스턴트와의 채팅 사이를 자주 전환해야 합니다. 이 서버는 ChatGPT, Claude, Codex 및 기타 MCP 클라이언트가 대화 중에 직접 Things 데이터를 읽고 수정할 수 있도록 하여 이러한 불편함을 해소합니다. 채팅 창을 나가지 않고도 오늘의 작업 요약을 요청하거나, 체크리스트가 포함된 새로운 할 일을 만들거나, 오래된 항목을 검색할 수 있습니다.

작동 방식

이 서버는 로컬 모델 컨텍스트 프로토콜(MCP) 서버입니다. 공식 Things URL 스킴(및 URL 스킴으로 부족한 일부 작업을 위한 AppleScript)을 사용하여 Things 3와 통신합니다. 설치(uvx things-mcp 또는 원클릭 패키지 사용) 후 Claude Desktop이나 ChatGPT Work와 같은 MCP 클라이언트에 연결하면, 어시스턴트가 일련의 도구에 액세스할 수 있게 됩니다. 이러한 도구에는 모든 표준 목록(받은 편지함, 오늘, 예정, 기타) 읽기, 할 일 및 프로젝트 생성/업데이트, 태그 관리, 고급 검색 수행이 포함됩니다. 서버는 Mac에서 실행되므로 Things 3가 설치되어 있고 “Things URL 활성화”가 켜져 있는 경우에만 작동합니다.

대상 사용자

macOS에서 Things 3를 사용하며 ChatGPT, Claude, Codex와 같은 AI 어시스턴트를 정기적으로 사용하는 개인을 위한 도구입니다. 매번 Things 앱을 여는 대신 자연어 요청을 입력하여 개인 작업을 관리하려는 모든 사용자에게 적합합니다. 팀 협업 도구가 아니며, 단일 사용자의 로컬 작업 데이터베이스에만 연결됩니다.

주요 특징

• 모든 주요 Things 목록에 대한 액세스: 받은 편지함, 오늘, 예정, 언젠가, 로그북, 휴지통 등
• 채팅에서 직접 할 일, 프로젝트 및 영역 생성, 업데이트 및 관리
• 사용하지 않는 태그를 정리하기 위한 사용량 보고서를 포함한 태그 작업
• 상태, 날짜, 태그, 프로젝트 및 생성 시간 필터가 포함된 고급 검색
• 중첩된 데이터 지원(영역은 프로젝트를 포함하고, 프로젝트는 할 일과 제목을 포함)
• '언젠가' 프로젝트는 '오늘', '예정', '언제든' 보기에서 자동으로 제외되어 Things UI 동작과 일치
• 읽기 도구에 대한 페이지 매기기 및 구조화된 콘텐츠 제공으로 원시 데이터에 대한 프로그래밍 방식 액세스 가능
• 일괄 작업: 여러 할 일을 한 번에 업데이트(일정 변경, 태그 설정, 완료 표시 등)
• 원격 액세스를 위한 선택적 HTTP 전송(기본값은 stdio)