bldinit Google Tasks Rest API

The google_tasks-rest API from bldinit — 4 operation(s) for google_tasks-rest.

GitHub OpenAPI

Operations 7

GET /api/v1/google_tasks/tasks/v1/users/@me/lists Google Tasks 할 일 목록 전체 조회 #
GET /api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks 지정한 할 일 목록의 할 일 조회 #
POST /api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks 새 할 일 추가 (write) #
GET /api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks/{task} 할 일 단건 조회 #
PUT /api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks/{task} 할 일 수정 — 완료처리 = status="completed" (write) #
DELETE /api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks/{task} [⚠️ 되돌릴 수 없음] 할 일 영구 삭제 (write — irreversible!) #
POST /api/v1/google_tasks/tasks/v1/lists/{tasklist}/tasks/{task}/move 할 일 재정렬 / 계층 이동 (write) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-tasks-rest-api"
All apis
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.

Get an API 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 Specification

mcpweave-com-google-tasks-rest-api-openapi.yml Raw ↑
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)