Skip to main content
Glama
Sign In
Google Tasks MCP Server

Google Tasks MCP Server

by odise444
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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

제목/메모/마감일 수정

Related MCP server: google-tasks-mcp

설치 방법

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

코드 내 하드코딩

Available Tools

6 tools
tasks_addGoogle Tasks 할 일 추가A

Google Tasks에 새 할 일을 추가합니다.

Args:

  • title (string): 할 일 제목 (필수)

  • notes (string): 메모/설명 (선택)

  • due (string): 마감일 ISO 형식 예) "2026-03-31T00:00:00.000Z" (선택)

  • listId (string): 추가할 목록 ID (선택, 기본값: 기본 목록)

Returns:

  • 추가된 할 일의 id와 title

Examples:

  • "BMS 테스트 추가해줘" -> tasks_add({title: "BMS 테스트"})

  • "내일까지 보고서 작성 추가" -> tasks_add({title: "보고서 작성", due: "2026-03-26T..."})

  • "메모 포함해서 추가" -> tasks_add({title: "...", notes: "세부 내용"})

Inputs: title (required), due, notes, listId.

tasks_completeGoogle Tasks 완료 처리A
Idempotent

Google Tasks의 할 일을 완료 처리합니다.

tasks_list로 조회한 id 값을 사용하세요.

Args:

  • id (string): 완료 처리할 할 일 ID (tasks_list에서 확인)

  • listId (string): 해당 할 일이 속한 목록 ID

Examples:

  • "여권 확인 완료했어" -> tasks_complete({id: "...", listId: "..."})

  • "첫 번째 항목 체크해줘" -> tasks_list() 후 id 확인 -> tasks_complete()

Inputs: id (required), listId.

tasks_deleteGoogle Tasks 삭제A
Destructive

Google Tasks에서 할 일을 영구 삭제합니다. 되돌릴 수 없습니다.

Args:

  • id (string): 삭제할 할 일 ID

  • listId (string): 목록 ID (선택)

Examples:

  • "바이낸스 항목 삭제해줘" -> tasks_list()로 id 확인 -> tasks_delete({id: "..."})

Inputs: id (required), listId.

tasks_listGoogle Tasks 목록 조회A
Read-onlyIdempotent

Google Tasks의 모든 할 일을 조회합니다.

완료된 항목과 미완료 항목을 모두 반환합니다. 각 항목에는 id, 제목, 상태, 마감일, 메모, 목록 이름이 포함됩니다.

Returns:

  • tasks: 할 일 배열 (id, title, status, due, notes, listTitle)

  • total: 전체 개수

  • pending: 미완료 개수

Examples:

  • "할 일 목록 보여줘" -> tasks_list()

  • "Tasks 전체 조회" -> tasks_list()

  • "완료 안 된 것만 보여줘" -> tasks_list() 후 status 필터링

Inputs: filter.

tasks_uncompleteGoogle Tasks 완료 취소A
Idempotent

완료 처리된 할 일을 미완료 상태로 되돌립니다.

Args:

  • id (string): 되돌릴 할 일 ID

  • listId (string): 목록 ID (선택)

Inputs: id (required), listId.

tasks_updateGoogle Tasks 수정A
Idempotent

Google Tasks의 할 일 제목, 메모, 마감일을 수정합니다.

Args:

  • id (string): 수정할 할 일 ID

  • title (string): 새 제목 (선택)

  • notes (string): 새 메모 (선택)

  • due (string): 새 마감일 ISO 형식 (선택)

  • listId (string): 목록 ID (선택)

Examples:

  • "360V BMS에 메모 추가해줘" -> tasks_update({id: "...", notes: "새 메모"})

  • "제목 바꿔줘" -> tasks_update({id: "...", title: "새 제목"})

Inputs: id (required), due, notes, title, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct action on tasks: list, add, complete, uncomplete, delete, and update. There is no overlap or ambiguity between these operations.

    Naming Consistency5/5

    All tool names follow a consistent 'tasks_' + verb pattern (list, add, complete, uncomplete, delete, update). The naming is predictable and uniform.

    Tool Count5/5

    6 tools is well-scoped for a task management server, covering the main lifecycle operations without unnecessary bloat.

    Completeness3/5

    CRUD and status transitions are covered, but tasks_complete requires a listId that tasks_list does not return (only listTitle). This creates a dead end for completing tasks, and there is no tool to list existing lists to obtain IDs.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers