이 모델 Context Protocol (MCP) 서버는 MCP 클라이언트와 Google Task 사이의 브리지를 제공하여 Claude Desktop, Cursor 및 Codex와 같은 클라이언트에서 작업 목록과 작업을 직접 관리 할 수 있습니다.

[!노트] 이 프로젝트의 모든 (바 일부 편집) 코드는 "vibe coded"였습니다. Claude/Copilot으로 제작되었습니다.

특징

이 MCP 서버는 다음과 같은 기능을 제공합니다:

작업 목록 관리

• list-tasklists - 모든 작업 목록
• get-tasklist - 특정 작업 목록에 대한 세부 정보를 얻으십시오.
• create-tasklist - 새로운 작업 목록 만들기
• update-tasklist - 기존 작업 목록 업데이트
• delete-tasklist - 작업 목록 삭제

작업 관리

• list-tasks - 질화 결과를 포함한 작업 목록에서 모든 작업을 나열
• get-task - 특정 작업에 대한 세부 정보를 얻기
• create-task - 새로운 작업 만들기
• update-task - 기존의 작업을 업데이트
• delete-task - 작업 삭제
• complete-task - 완료된 작업 표시
• move-task - 작업 이동 (주문, 부모 변경, 또는 작업 목록에서 이동)
• clear-completed-tasks - 목록에서 완료된 모든 작업을 취소

설치 설명서

##1. Google Cloud Project & Enable API 생성

1. 명세.

Google Tasks MCP Server

This Model Context Protocol (MCP) server provides a bridge between MCP clients and Google Tasks, allowing you to manage your task lists and tasks directly from clients like Claude Desktop, Cursor, and Codex.

[!NOTE] All (bar some edits) code in this project was “vibe coded” - generated with Claude/Copilot with instructions from me.

Features

This MCP server provides the following functionality:

Task List Management

• list-tasklists - List all your task lists
• get-tasklist - Get details about a specific task list
• create-tasklist - Create a new task list
• update-tasklist - Update an existing task list
• delete-tasklist - Delete a task list

Task Management

• list-tasks - List all tasks in a task list, including paginated results
• get-task - Get details about a specific task
• create-task - Create a new task
• update-task - Update an existing task
• delete-task - Delete a task
• complete-task - Mark a task as completed
• move-task - Move a task (reorder, change parent, or move across task lists)
• clear-completed-tasks - Clear all completed tasks from a list

Setup Instructions

1. Create Google Cloud Project & Enable API

1. Go to the Google Cloud Console
2. Create a new project
3. Navigate to “APIs & Services” > “Library”
4. Search for “Google Tasks API” and enable it
5. Go to “APIs & Services” > “Credentials”
6. Click “Create Credentials” > “OAuth Client ID”
7. Configure the OAuth consent screen (External is fine for personal use)
8. For Application Type, select “Web application”
9. Add “http://localhost:3000/oauth2callback” as an authorized redirect URI
10. Create the client ID and secret

2. Configure Environment Variables

Create a .env file in this project directory:

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback

Environment Variables:

• GOOGLE_CLIENT_ID (required) - Your Google OAuth Client ID
• GOOGLE_CLIENT_SECRET (required) - Your Google OAuth Client Secret
• GOOGLE_REDIRECT_URI (optional) - OAuth redirect URI (defaults to http://localhost:3000/oauth2callback)

Note: The server validates that GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET are set at startup and will fail with clear error messages if they are missing or invalid.

3. Build the Server

1. Install dependencies:

npm install

2. Build the server:

npm run build

4. Configure an MCP Client

Codex

Add the server to ~/.codex/config.toml:

[mcp_servers.google-tasks]
command = "zsh"
args = ["-lc", "cd /path/to/google-tasks-mcp && exec node build/index.js"]

Replace /path/to/google-tasks-mcp with the path to this project, then restart Codex.

To verify the server is registered:

codex mcp list
codex mcp get google-tasks