Things Safe MCP

Things 3용 비공식 MCP 서버로, Cultured Code가 안전하다고 문서화한 통합 방법만 사용합니다:

• 읽기와 일반적인 작업 편집에는 AppleScript.

• 체크리스트 편집에는 Things URL 스킴.

Things 데이터베이스, 앱 지원 파일 또는 Things Cloud 자격 증명을 절대 읽거나 쓰지 않습니다. macOS 전용이며 Things 3가 필요합니다.

설치

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

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

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

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

첫 요청 전에 Things를 한 번 실행하세요. macOS에서 MCP 호스트가 Things를 자동화할 수 있는 권한을 요청합니다.

체크리스트 토큰

체크리스트 편집에만 Things URL 인증 토큰이 필요합니다. Things에서 설정 → 일반 → Things URL 활성화 → 관리를 열고 토큰을 생성한 다음, MCP 클라이언트의 보안 환경 설정을 통해 서버에 THINGS_AUTH_TOKEN으로 제공하세요. 커밋하거나 공유하지 마세요.

다른 모든 작업은 토큰 없이 작동합니다.

도구

• Inbox, Today, Upcoming, Anytime, Someday, 프로젝트, 프로젝트 작업 및 직접 태그된 작업을 읽습니다.

• 작업 제목과 메모를 검색합니다.

• 작업을 생성합니다.

• 제목, 메모, 태그, 상태, 일정 및 프로젝트 지정을 편집합니다. 빈 프로젝트 ID를 전달하면 작업을 분리합니다.

• 체크리스트 항목을 교체, 추가 또는 앞에 삽입합니다.

안전 및 개인정보 보호

Cultured Code는 AppleScript와 Things URL 스킴을 안전한 연결 방법으로 명시합니다. 이 서버는 사용자 입력을 AppleScript 소스에 삽입하지 않고 프로세스 인수로 전달합니다.

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

• 제3자 AI 도구와 Things

• Things AppleScript 명령

• Things URL 스킴

개발

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

테스트는 모든 외부 프로세스를 모의(mock) 처리하며 Things에 절대 접근하지 않습니다.

라이선스

MIT