MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 21:29
태그:
#MCP #커뮤니티 #서버 #생산성 #태스크관리

링크된 문서

역링크

Google Tasks

Google Tasks

Google Tasks MCP 서버는 Google Tasks API와 상호작용할 수 있는 Model Context Protocol 서버입니다. 이 서버를 통해 AI 어시스턴트는 사용자의 작업 목록을 조회, 생성, 수정 및 관리할 수 있습니다.

특징

  • 작업 목록 조회 및 관리
  • 작업 생성, 수정, 완료 및 삭제
  • 작업 세부 정보(제목, 메모, 마감일 등) 관리
  • 하위 작업 및 계층적 작업 구조 지원
  • 작업 우선순위 및 정렬 순서 설정
  • 작업 상태(완료/미완료) 관리
  • 작업 간 이동 및 복사
  • 여러 작업 목록 관리
  • Google Calendar와의 통합
  • Gmail 및 기타 Google 서비스와의 연동
  • 주기적인 작업 설정 지원
  • 작업 검색 및 필터링
  • 대량 작업 처리 최적화
  • 작업 완료 기록 및 통계

API

리소스

gtasks://tasklists

  • 사용자의 모든 작업 목록 정보를 제공합니다.

gtasks://tasklists/{tasklist_id}/tasks

  • 특정 작업 목록의 모든 작업 정보를 제공합니다.

gtasks://tasklists/{tasklist_id}/tasks/{task_id}

  • 특정 작업의 세부 정보를 제공합니다.

도구

작업 목록 관리

list_task_lists

사용자의 모든 작업 목록을 조회합니다. - 입력: - max_results: (선택적) 최대 결과 수 - page_token: (선택적) 페이지 토큰 - 출력: 작업 목록 ID, 제목, 업데이트 시간 등을 포함한 작업 목록

get_task_list

특정 작업 목록의 정보를 조회합니다. - 입력: - tasklist_id: 작업 목록 ID - 출력: 작업 목록 상세 정보

create_task_list

새 작업 목록을 생성합니다. - 입력: - title: 작업 목록 제목 - 출력: 생성된 작업 목록 정보

update_task_list

작업 목록을 업데이트합니다. - 입력: - tasklist_id: 작업 목록 ID - title: 새 작업 목록 제목 - 출력: 업데이트된 작업 목록 정보

delete_task_list

작업 목록을 삭제합니다. - 입력: - tasklist_id: 삭제할 작업 목록 ID - 출력: 삭제 결과

작업 관리

list_tasks

작업 목록의 작업을 조회합니다. - 입력: - tasklist_id: 작업 목록 ID - max_results: (선택적) 최대 결과 수 - show_completed: (선택적) 완료된 작업 포함 여부 - show_hidden: (선택적) 숨겨진 작업 포함 여부 - show_deleted: (선택적) 삭제된 작업 포함 여부 - completed_min: (선택적) 최소 완료 시간 - completed_max: (선택적) 최대 완료 시간 - due_min: (선택적) 최소 마감일 - due_max: (선택적) 최대 마감일 - updated_min: (선택적) 최소 업데이트 시간 - page_token: (선택적) 페이지 토큰 - 출력: 작업 목록

get_task

특정 작업의 정보를 조회합니다. - 입력: - tasklist_id: 작업 목록 ID - task_id: 작업 ID - 출력: 작업 상세 정보

create_task

새 작업을 생성합니다. - 입력: - tasklist_id: 작업 목록 ID - title: 작업 제목 - notes: (선택적) 작업 메모 - due: (선택적) 마감일 - status: (선택적) 작업 상태 (needsAction, completed) - parent: (선택적) 상위 작업 ID - previous: (선택적) 이전 작업 ID (정렬 순서용) - 출력: 생성된 작업 정보

update_task

작업을 업데이트합니다. - 입력: - tasklist_id: 작업 목록 ID - task_id: 작업 ID - title: (선택적) 새 작업 제목 - notes: (선택적) 새 작업 메모 - due: (선택적) 새 마감일 - status: (선택적) 새 작업 상태 - parent: (선택적) 새 상위 작업 ID - previous: (선택적) 새 이전 작업 ID - 출력: 업데이트된 작업 정보

complete_task

작업을 완료로 표시합니다. - 입력: - tasklist_id: 작업 목록 ID - task_id: 작업 ID - completed: (선택적) 완료 시간 (기본값: 현재 시간) - 출력: 완료된 작업 정보

delete_task

작업을 삭제합니다. - 입력: - tasklist_id: 작업 목록 ID - task_id: 삭제할 작업 ID - 출력: 삭제 결과

clear_completed_tasks

완료된 모든 작업을 삭제합니다. - 입력: - tasklist_id: 작업 목록 ID - 출력: 삭제 결과

작업 정렬 및 구성

move_task

작업의 위치를 이동합니다. - 입력: - tasklist_id: 작업 목록 ID - task_id: 작업 ID - parent: (선택적) 새 상위 작업 ID - previous: (선택적) 새 이전 작업 ID - 출력: 이동된 작업 정보

reorder_tasks

여러 작업의 순서를 재정렬합니다. - 입력: - tasklist_id: 작업 목록 ID - task_ids: 순서대로 정렬할 작업 ID 배열 - 출력: 재정렬 결과

move_task_to_list

작업을 다른 작업 목록으로 이동합니다. - 입력: - source_tasklist_id: 원본 작업 목록 ID - task_id: 작업 ID - target_tasklist_id: 대상 작업 목록 ID - 출력: 이동된 작업 정보

검색 및 필터링

search_tasks

모든 작업 목록에서 작업을 검색합니다. - 입력: - query: 검색 쿼리 - include_completed: (선택적) 완료된 작업 포함 여부 - max_results: (선택적) 최대 결과 수 - due_min: (선택적) 최소 마감일 - due_max: (선택적) 최대 마감일 - 출력: 검색 결과 목록

get_tasks_by_due_date

특정 마감일이 있는 작업을 조회합니다. - 입력: - date: 조회할 마감일 - include_completed: (선택적) 완료된 작업 포함 여부 - 출력: 해당 마감일의 작업 목록

get_overdue_tasks

기한이 지난 작업을 조회합니다. - 입력: - include_completed: (선택적) 완료된 작업 포함 여부 - 출력: 기한이 지난 작업 목록

통계 및 보고서

get_task_stats

작업 통계를 조회합니다. - 입력: - tasklist_id: (선택적) 작업 목록 ID (생략 시 모든 목록) - start_date: (선택적) 시작 날짜 - end_date: (선택적) 종료 날짜 - 출력: 작업 통계 (완료 수, 미완료 수, 완료율 등)

generate_task_report

기간별 작업 완료 보고서를 생성합니다. - 입력: - start_date: 시작 날짜 - end_date: 종료 날짜 - group_by: (선택적) 그룹화 기준 (day, week, month) - 출력: 그룹화된 기간별 작업 완료 통계

사용 방법

설치 및 구성

  1. 사전 요구 사항:
  2. Google 계정
  3. Google Tasks API 접근 권한

  4. OAuth 2.0 인증 설정

  5. MCP 서버 설치: 

    pip install googletasks-mcp-server

  6. Claude Desktop 구성: 

    {
  "mcpServers": {
    "googletasks": {
      "command": "python",
      "args": ["-m", "googletasks_mcp"],
      "env": {
        "GOOGLE_TASKS_CLIENT_ID": "your-client-id",
        "GOOGLE_TASKS_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_TASKS_REDIRECT_URI": "your-redirect-uri",
        "GOOGLE_TASKS_DEFAULT_TASKLIST": "your-default-tasklist-id"
      }
    }
  }
}

  7. OAuth 인증 설정:

  8. Google Cloud Console에서 프로젝트 생성
  9. Google Tasks API 활성화
  10. OAuth 2.0 클라이언트 ID 생성
  11. 적절한 스코프 설정 (https://www.googleapis.com/auth/tasks)

  12. 리디렉션 URI 구성

  13. 구성 옵션:

  14. GOOGLE_TASKS_CLIENT_ID: OAuth 클라이언트 ID
  15. GOOGLE_TASKS_CLIENT_SECRET: OAuth 클라이언트 시크릿
  16. GOOGLE_TASKS_REDIRECT_URI: OAuth 리디렉션 URI
  17. GOOGLE_TASKS_DEFAULT_TASKLIST: 기본 작업 목록 ID
  18. GOOGLE_TASKS_TOKEN_PATH: 토큰 저장 경로
  19. GOOGLE_TASKS_CACHE_TTL: 캐시 수명(초) (기본값: 300)
  20. GOOGLE_TASKS_LOG_LEVEL: 로그 수준 (기본값: INFO)

기본 사용 예시

  1. 작업 목록 조회: 

    list_task_lists({
  max_results: 10
})

  2. 작업 목록의 작업 조회: 

    list_tasks({
  tasklist_id: "@default",
  show_completed: false,
  max_results: 20
})

  3. 새 작업 생성: 

    create_task({
  tasklist_id: "@default",
  title: "보고서 작성하기",
  notes: "분기별 마케팅 성과 보고서 작성",
  due: "2025-05-20T00:00:00Z"
})

  4. 하위 작업 생성: 

    create_task({
  tasklist_id: "@default",
  title: "데이터 수집",
  notes: "지난 분기 마케팅 캠페인 데이터 수집",
  due: "2025-05-18T00:00:00Z",
  parent: "task123" // 상위 작업 ID
})

  5. 작업 완료로 표시: 

    complete_task({
  tasklist_id: "@default",
  task_id: "task123"
})

  6. 오늘 마감인 작업 조회: 

    get_tasks_by_due_date({
  date: "2025-05-14",
  include_completed: false
})

  7. 기한이 지난 작업 조회: 

    get_overdue_tasks({
  include_completed: false
})

  8. 작업 통계 조회: 

    get_task_stats({
  start_date: "2025-05-01",
  end_date: "2025-05-14"
})

보안 고려사항

  • Google API 자격 증명은 민감한 정보이므로 안전하게 관리해야 합니다.
  • OAuth 토큰은 안전하게 저장하고 관리해야 합니다.
  • 필요한 최소한의 권한만 요청하세요.
  • 민감한 작업 데이터가 포함된 경우 특별히 주의하세요.
  • API 호출 제한을 고려하여 불필요한 요청을 최소화하세요.

연결된 구성 요소

  • Google Calendar - 일정 확인, 시간 찾기, 이벤트 추가/삭제를 위한 Google Calendar 통합
  • Google Sheets - Google Sheets 데이터 접근 및 편집
  • Gmail - Claude Desktop에서 자동 인증 지원이 포함된 Gmail 통합을 위한 MCP 서버
  • Todoist - 작업 관리를 위한 Todoist와 상호작용
  • Anki - Anki 덱과 카드와 상호작용하는 MCP 서버