bldinit Google Tasks Rest API
The google_tasks-rest API from bldinit — 4 operation(s) for google_tasks-rest.
The google_tasks-rest API from bldinit — 4 operation(s) for google_tasks-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-tasks-rest-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Google Tasks Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: google_tasks-rest
paths:
/api/v1/google_tasks/tasks/v1/users/@me/lists:
get:
tags:
- google_tasks-rest
summary: Google Tasks 할 일 목록 전체 조회
description: '인증된 사용자의 모든 할 일 목록(TaskList)을 반환합니다.
최대 2,000개 목록 보유 가능. 응답에 ``kind``, ``etag``,
``nextPageToken``, ``items[]`` (TaskList 배열) 포함.
**사전 준비**:
1. GCP Console에서 ``Google Tasks API`` 활성화 필수.
2. 자기 GCP OAuth 앱에 ``tasks`` 스코프 동의.
**할 일 목록 ID(id 필드)**는 이후 ``google_tasks_list_tasks``,
``google_tasks_insert_task`` 등의 ``tasklist`` 파라미터로 사용합니다.
**응답 주요 필드**: kind / etag / nextPageToken / items[].id /
items[].title / items[].updated.
Native pass-through.'
operationId: google_tasks_list_tasklists
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: maxResults
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Maxresults
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks:
get:
tags:
- google_tasks-rest
summary: 지정한 할 일 목록의 할 일 조회
description: '지정한 할 일 목록(tasklist) 내의 할 일(Task)을 반환합니다.
기본적으로 완료 task 포함(showCompleted=true), 숨김/삭제 task 제외.
한 목록당 최대 20,000개 비숨김 task.
**tasklist**: ``google_tasks_list_tasklists`` 응답의 ``items[].id``.
**필터링 파라미터**:
- ``showCompleted``: 완료 task 포함 여부 (기본 true)
- ``showHidden``: ``tasks.clear`` 처리된 숨김 task 포함 여부 (기본 false)
- ``dueMin`` / ``dueMax``: 예정일 범위 필터 (RFC3339 형식)
**응답 주요 필드**: kind / etag / nextPageToken / items[].id /
items[].title / items[].status / items[].due / items[].notes.
Native pass-through.'
operationId: google_tasks_list_tasks
parameters:
- name: tasklist
in: path
required: true
schema:
type: string
title: Tasklist
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: maxResults
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Maxresults
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: showCompleted
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Showcompleted
- name: showHidden
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Showhidden
- name: dueMin
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Duemin
- name: dueMax
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Duemax
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
post:
tags:
- google_tasks-rest
summary: 새 할 일 추가 (write)
description: '지정한 할 일 목록(tasklist)에 새 할 일을 생성합니다.
한 목록당 최대 20,000개 비숨김 task, 사용자 전체 최대 100,000개.
**tasklist**: ``google_tasks_list_tasklists`` 응답의 ``items[].id``.
**요청 body 주요 필드**:
- ``title`` (권장): 할 일 제목. 최대 1,024자
- ``notes`` (선택): 메모. 최대 8,192자
- ``due`` (선택): 예정일 (RFC3339, 시각 무시 — 일 단위 저장)
- ``status`` (선택): ``"needsAction"`` (기본) 또는 ``"completed"``
출력전용 필드(kind, id, etag, updated, selfLink, parent, position 등)를
body에 포함해도 서버에서 무시됩니다.
**Destructive write — 새 task 생성 (삭제로 되돌릴 수 있음).**'
operationId: google_tasks_insert_task
parameters:
- name: tasklist
in: path
required: true
schema:
type: string
title: Tasklist
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks/{task}:
get:
tags:
- google_tasks-rest
summary: 할 일 단건 조회
description: '지정한 할 일(task)을 단건 반환합니다.
**tasklist**: ``google_tasks_list_tasklists`` 응답의 ``items[].id``.
**task**: ``google_tasks_list_tasks`` 응답의 ``items[].id``.
**응답 주요 필드**: id / title / status / due / notes / updated /
parent / position / webViewLink / assignmentInfo.
Native pass-through.'
operationId: google_tasks_get_task
parameters:
- name: tasklist
in: path
required: true
schema:
type: string
title: Tasklist
- name: task
in: path
required: true
schema:
type: string
title: Task
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
put:
tags:
- google_tasks-rest
summary: 할 일 수정 — 완료처리 = status="completed" (write)
description: '지정한 할 일을 전체 교체(PUT semantics)합니다.
완료 처리에 주로 사용: ``status: "completed"``.
> ``update`` 는 **reversible** — 재update 로 되돌릴 수 있음. ADR-030 적용 대상 아님.
**tasklist**: ``google_tasks_list_tasklists`` 응답의 ``items[].id``.
**task**: ``google_tasks_list_tasks`` 응답의 ``items[].id``.
**PUT semantics 주의**: 전체 교체 — 변경하지 않는 writable 필드도 현재값 포함 권장.
최소 필드: ``id`` (task ID, path param 과 동일값) + 변경할 필드.
**완료 처리 전형 패턴**:
```json
{"id": "{task_id}", "title": "기존 제목", "status": "completed"}
```
**Destructive write** (되돌리기 가능 — irreversible 아님).'
operationId: google_tasks_update_task
parameters:
- name: tasklist
in: path
required: true
schema:
type: string
title: Tasklist
- name: task
in: path
required: true
schema:
type: string
title: Task
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
delete:
tags:
- google_tasks-rest
summary: '[⚠️ 되돌릴 수 없음] 할 일 영구 삭제 (write — irreversible!)'
description: '지정한 할 일을 **영구 삭제**합니다.
⚠️ **Google Tasks 는 휴지통이 없어 삭제 시 영구 소멸** — 복구 불가.
- task 가 Docs/Chat Spaces 에서 assigned 된 경우: assigned task +
원본 task 모두 삭제됩니다.
- ``showDeleted=true`` 로 ``list_tasks`` 조회 시 ``deleted=true`` 플래그로
잠시 조회 가능하나, 데이터는 실질적으로 소멸 상태입니다.
**대안**: 완료 처리만 원하면 ``google_tasks_update_task`` 로
``status: "completed"`` 사용 (복구 가능).
**Destructive write — irreversible (영구 삭제, 복구 불가).**'
operationId: google_tasks_delete_task
parameters:
- name: tasklist
in: path
required: true
schema:
type: string
title: Tasklist
- name: task
in: path
required: true
schema:
type: string
title: Task
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks/{task}/move:
post:
tags:
- google_tasks-rest
summary: 할 일 재정렬 / 계층 이동 (write)
description: '지정한 할 일을 다른 위치로 이동합니다. 같은 목록 내 재정렬,
계층 변경(parent/child), 또는 다른 목록으로 이동 가능.
> **reversible** — 다시 move 로 되돌릴 수 있음. ADR-030 적용 대상 아님.
**tasklist**: 소스 할 일 목록 ID.
**task**: 이동할 할 일 ID.
**query 파라미터**:
- ``parent`` (선택): 새 상위 task ID. 최상위로 이동 시 생략.
- ``previous`` (선택): 새 앞 형제 task ID. 첫 번째 위치 시 생략.
- ``destinationTasklist`` (선택): 대상 목록 ID. 지정 시 목록 간 이동.
생략 시 현재 목록 내 재정렬. recurrent task 는 목록 간 이동 불가.
**응답**: 이동된 Task 객체 (parent / position 필드 갱신됨).
**Destructive write** (되돌리기 가능 — irreversible 아님).'
operationId: google_tasks_move_task
parameters:
- name: tasklist
in: path
required: true
schema:
type: string
title: Tasklist
- name: task
in: path
required: true
schema:
type: string
title: Task
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: parent
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Parent
- name: previous
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Previous
- name: destinationTasklist
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Destinationtasklist
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)