このモデルコンテキストプロトコル(MCP)サーバーは、MCP クライアントと Google タスク間でブリッジを提供し、Claude デスクトップ、カーソル、および Codex などのクライアントからタスクリストやタスクを直接管理できます。

[!NOTE] このプロジェクト内のすべての(バーの編集)コードは、「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クラウドプロジェクトの作成とAPIの有効化

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