gtasks-mcp - Google Tasks 모델 컨텍스트 프로토콜 서버

프로젝트 개요

gtasks-mcp는 Claude AI를 위해 특별히 설계된 Google Tasks 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 프로젝트를 통해 Claude는 Google Tasks API와 직접 통합되어 Google 작업에 대한 완전한 관리 기능을 구현할 수 있습니다.

프로젝트 주소: https://github.com/zcaceres/gtasks-mcp

주요 기능

핵심 도구 (Tools)

1. search - 작업 검색

• 기능 설명: Google Tasks에서 작업 검색
• 입력 매개변수:
  • query (string): 검색 쿼리 문자열
• 반환 결과: 일치하는 작업 상세 정보

2. list - 작업 목록

• 기능 설명: Google Tasks의 모든 작업 목록 표시
• 입력 매개변수:
  • cursor (string, 선택 사항): 페이지네이션 커서
• 반환 결과: 모든 작업 목록

3. create - 작업 생성

• 기능 설명: Google Tasks에 새 작업 생성
• 입력 매개변수:
  • taskListId (string, 선택 사항): 작업 목록 ID
  • title (string, 필수): 작업 제목
  • notes (string, 선택 사항): 작업 메모
  • due (string, 선택 사항): 마감일
• 반환 결과: 작업 생성 확인 정보

4. update - 작업 업데이트

• 기능 설명: 기존 Google Tasks 작업 업데이트
• 입력 매개변수:
  • taskListId (string, 선택 사항): 작업 목록 ID
  • id (string, 필수): 작업 ID
  • uri (string, 필수): 작업 URI
  • title (string, 선택 사항): 새 작업 제목
  • notes (string, 선택 사항): 새 작업 메모
  • status (string, 선택 사항): 새 작업 상태 ("needsAction" 또는 "completed")
  • due (string, 선택 사항): 새 마감일
• 반환 결과: 작업 업데이트 확인 정보

5. delete - 작업 삭제

• 기능 설명: Google Tasks에서 작업 삭제
• 입력 매개변수:
  • taskListId (string, 필수): 작업 목록 ID
  • id (string, 필수): 작업 ID
• 반환 결과: 작업 삭제 확인 정보

6. clear - 완료된 작업 지우기

• 기능 설명: Google Tasks 작업 목록에서 완료된 작업 지우기
• 입력 매개변수:
  • taskListId (string, 필수): 작업 목록 ID
• 반환 결과: 지우기 작업 확인 정보

리소스 (Resources)

서버는 Google Tasks 리소스에 대한 액세스를 제공합니다.

• 작업 리소스 (gtasks:///<task_id>)
  • Google Tasks의 단일 작업을 나타냅니다.
  • 제목, 상태, 마감일, 메모 및 기타 메타데이터를 포함한 작업 상세 정보 읽기를 지원합니다.
  • 제공된 도구를 사용하여 목록 표시, 읽기, 생성, 업데이트 및 삭제 작업을 수행할 수 있습니다.

설치 및 구성

사전 요구 사항

1. Google Cloud 프로젝트 생성

   • Google Cloud Console에 접속하여 새 프로젝트 생성

2. Google Tasks API 활성화

   • Google Cloud Console에서 API 활성화

3. OAuth 동의 화면 구성

   • OAuth 동의 화면에서 구성
   • 테스트 환경은 "internal" 선택
   • 범위 추가: https://www.googleapis.com/auth/tasks

4. OAuth 클라이언트 ID 생성

   • 인증 정보 페이지에서 생성
   • 애플리케이션 유형은 "데스크톱 앱" 선택
   • OAuth 키의 JSON 파일 다운로드
   • 키 파일 이름을 gcp-oauth.keys.json으로 변경하고 프로젝트 루트 디렉토리에 배치

프로젝트 빌드

다음 명령을 사용하여 서버를 빌드합니다.

npm run build

또는 감시 모드를 사용합니다.

npm run watch

자동 설치 (권장)

Smithery를 통해 자동 설치:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

인증

1. 서버를 실행하고 인증을 수행합니다.

npm run start auth

2. 시스템 브라우저에서 인증 프로세스가 열립니다.
3. 인증 프로세스 완료
4. 인증 정보는 프로젝트 루트 디렉토리(.gdrive-server-credentials.json)에 저장됩니다.

Claude Desktop 통합

이 서버를 Claude Desktop 애플리케이션과 통합하려면 애플리케이션의 서버 구성에 다음 내용을 추가하십시오.

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

기술 특징

• 완전한 CRUD 작업: 작업 생성, 읽기, 업데이트, 삭제 지원
• 고급 검색 기능: 키워드를 기반으로 작업 검색 가능
• 작업 상태 관리: 작업을 완료 또는 대기 중으로 표시 지원
• 페이지네이션 지원: 많은 작업을 처리할 때 페이지네이션 기능 제공
• OAuth 2.0 인증: 안전한 Google API 액세스
• TypeScript 지원: 타입 안전성과 더 나은 개발 경험 제공

사용 시나리오

• 개인 작업 관리: Claude 자연어 상호 작용을 통해 일상적인 할 일 관리
• 프로젝트 협업: 팀 프로젝트에서 AI 도우미를 통해 작업 할당 관리
• 자동화된 워크플로우: 다른 도구와 결합하여 작업 관리 자동화
• 생산성 향상: 음성 또는 텍스트를 통해 빠르게 작업 생성 및 업데이트

주의 사항

• 유효한 Google 계정 및 Google Tasks 액세스 권한 필요
• 처음 사용할 때 OAuth 인증 프로세스를 완료해야 함
• 프로덕션 환경에서는 인증 정보 파일을 안전하게 보관하는 것이 좋습니다.
• Google API 사용 할당량 및 제한 사항 준수