Google Tasks MCP Server

Google Tasks를 Claude Code에서 자연어로 관리할 수 있는 MCP 서버입니다. Apps Script 웹훅을 통해 Google Tasks API와 통신합니다.

제공 도구

도구	설명
tasks_list	전체 할 일 조회 (필터: all/pending/completed)
tasks_add	새 할 일 추가 (제목, 메모, 마감일)
tasks_complete	완료 처리
tasks_uncomplete	완료 취소
tasks_delete	삭제
tasks_update	제목/메모/마감일 수정

설치 방법

1. 서버 파일 복사

이 폴더를 원하는 위치에 복사합니다. 예:

C:\Users\사용자명\google-tasks-mcp-server\

2. 의존성 설치 및 빌드

npm install
npm run build

3. Claude Code에 MCP 등록

방법 A: claude mcp add 명령어 (권장)

claude mcp add google-tasks \
  -e TASKS_WEBHOOK_URL="https://script.google.com/macros/s/AKfycbyVoSfsWx3A9qfUQjt8_zM4nreF7ybZ___VZPXhF1x9CFQy1Uga6s3gGCbBOrLJ7esz/exec" \
  -e TASKS_DEFAULT_LIST_ID="MDg1NzM1NTk5OTc1NDI4NTQyMzE6MDow" \
  -- node "C:/Users/사용자명/google-tasks-mcp-server/dist/index.js"

방법 B: 설정 파일 직접 수정

%APPDATA%\Claude\claude_desktop_config.json (또는 Claude Code 설정 파일)에 추가:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["C:/Users/사용자명/google-tasks-mcp-server/dist/index.js"],
      "env": {
        "TASKS_WEBHOOK_URL": "https://script.google.com/macros/s/AKfycbyVoSfsWx3A9qfUQjt8_zM4nreF7ybZ___VZPXhF1x9CFQy1Uga6s3gGCbBOrLJ7esz/exec",
        "TASKS_DEFAULT_LIST_ID": "MDg1NzM1NTk5OTc1NDI4NTQyMzE6MDow"
      }
    }
  }
}

4. Claude Code 재시작

설정 후 Claude Code를 재시작하면 google-tasks MCP 서버가 활성화됩니다.

사용 예시

Claude Code에서 자연어로:

할 일 목록 보여줘
→ tasks_list() 호출

360V BMS CAN 통신 테스트 추가해줘
→ tasks_add({title: "360V BMS CAN 통신 테스트"}) 호출

여권 만료 기간 확인 완료 처리해줘
→ tasks_list()로 id 찾은 뒤 tasks_complete({id: "..."}) 호출

기아오토카 메모에 '레이 리콜 접수 완료' 추가해줘
→ tasks_update({id: "...", notes: "레이 리콜 접수 완료"}) 호출

환경 변수

변수	설명	기본값
TASKS_WEBHOOK_URL	Apps Script 웹앱 URL	코드 내 하드코딩
TASKS_DEFAULT_LIST_ID	기본 목록 ID	코드 내 하드코딩