이 MCP 서버는 Google Tasks와 연동되어 작업 목록, 읽기, 검색, 생성, 업데이트, 삭제를 가능하게 합니다.

구성 요소

도구

• 검색

• Google 작업에서 작업 검색

• 입력: query (문자열): 검색 쿼리

• 세부 정보를 포함한 작업 일치 반환

• 목록

• 구글 작업에서 모든 작업 목록

• 선택적 입력: cursor (문자열): 페이지네이션을 위한 커서

• 모든 작업 목록을 반환합니다

• 만들기

• Google 작업에서 새 작업 생성

• 입력:

• taskListId (문자열, 선택사항): 작업 목록 ID

• title (문자열, 필수): 작업 제목

• notes (문자열, 선택 사항): 작업 노트

• due (문자열, 선택): 마감일

• 작업 생성 확인 반환

• 업데이트

• Google 작업에서 기존 작업 업데이트

• 입력:

• taskListId (문자열, 선택 사항): 작업 목록 ID

• id (문자열, 필수): 작업 ID

• uri (문자열, 필요): 작업 URI

• title (문자열, 선택): 새 작업 제목

• notes (문자열, 선택 사항): 새로운 작업 노트

• status (문자열, 선택): 새 작업 상태 (“needsAction” 또는 “완료”)

• due (문자열, 선택 사항): 새로운 마감일

• 작업 업데이트 확인 반환

• 삭제

• Google 작업에서 작업 삭제

• 입력:

Google Tasks MCP Server

This MCP server integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.

Components

Tools

• search

  • Search for tasks in Google Tasks
  • Input: query (string): Search query
  • Returns matching tasks with details

• list

  • List all tasks in Google Tasks
  • Optional input: cursor (string): Cursor for pagination
  • Returns a list of all tasks

• create

  • Create a new task in Google Tasks
  • Input:
    • taskListId (string, optional): Task list ID
    • title (string, required): Task title
    • notes (string, optional): Task notes
    • due (string, optional): Due date
  • Returns confirmation of task creation

• update

  • Update an existing task in Google Tasks
  • Input:
    • taskListId (string, optional): Task list ID
    • id (string, required): Task ID
    • uri (string, required): Task URI
    • title (string, optional): New task title
    • notes (string, optional): New task notes
    • status (string, optional): New task status (“needsAction” or “completed”)
    • due (string, optional): New due date
  • Returns confirmation of task update

• delete

  • Delete a task in Google Tasks
  • Input:
    • taskListId (string, required): Task list ID
    • id (string, required): Task ID
  • Returns confirmation of task deletion

• clear

  • Clear completed tasks from a Google Tasks task list
  • Input: taskListId (string, required): Task list ID
  • Returns confirmation of cleared tasks

Resources

The server provides access to Google Tasks resources:

• Tasks (gtasks:///)
  • Represents individual tasks in Google Tasks
  • Supports reading task details including title, status, due date, notes, and other metadata
  • Can be listed, read, created, updated, and deleted using the provided tools

Getting started

1. Create a new Google Cloud project
2. Enable the Google Tasks API
3. Configure an OAuth consent screen (“internal” is fine for testing)
4. Add scopes https://www.googleapis.com/auth/tasks
5. Create an OAuth Client ID for application type “Desktop App”
6. Download the JSON file of your client’s OAuth keys
7. Rename the key file to gcp-oauth.keys.json and place into the root of this repo (i.e. gcp-oauth.keys.json)

Make sure to build the server with either npm run build or npm run watch.

Installing via Smithery

To install Google Tasks Server for Claude Desktop automatically via Smithery: