gtasks-mcp

Google Tasks MCP Server

Google Tasks 用の Model Context Protocol（MCP）サーバーです。Claude Desktop やその他の MCP クライアントから、自然言語でタスクリストやタスクを管理できます。

zcaceres/gtasks-mcp からフォークし、より強固な認証オプション、複数リストへの対応、ページネーション、階層を扱うツールを追加しています。

レジストリ名： io.github.alvinjchoi/gtasks-mcp
npm： @alvincrave/gtasks-mcp

機能

• タスクの一覧表示と検索（必要に応じて特定のタスクリストに限定）
• すべてのタスクをページネーションで取得（100 件で暗黙に上限となることはありません）
• タスクの作成、更新、削除、完了済みタスクの一括削除
• タスクリストの確認（list_task_lists）
• 親子階層の表示（list_with_tree）
• タスクの並べ替え、ネスト、リスト間の移動（move）
• 環境変数、認証情報ファイル、対話型の auth による OAuth2 認証
• Docker 対応

インストール

推奨（Claude Desktop／任意の MCP クライアント）— 公開済みの最新 npm パッケージを実行します。

npx -y @alvincrave/gtasks-mcp

または、グローバルにインストールします。

npm install -g @alvincrave/gtasks-mcp

ソースからインストール

git clone https://github.com/alvinjchoi/gtasks-mcp.git
cd gtasks-mcp
npm install
npm run build

セットアップ

オプション A — 環境変数（Claude Desktop）

1. Google Cloud プロジェクトを作成し、Google Tasks API を有効にします。
2. OAuth 2.0 デスクトップ認証情報を作成し、更新トークンを取得します（スコープ https://www.googleapis.com/auth/tasks を指定した OAuth Playground を使用できます）。
3. Claude Desktop を設定します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "gtasks": {
      "command": "npx",
      "args": ["-y", "@alvincrave/gtasks-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
      }
    }
  }
}

オプション B — 認証情報ファイル（ローカル／他の Google MCP サーバーとの共有）

1. OAuth クライアント JSON（gcp-oauth.keys.json）をダウンロードします。
2. 一度認証します。

export GTASKS_CREDENTIALS_PATH=/path/to/gcp-oauth.keys.json
export GTASKS_TOKEN_PATH=/path/to/.gtasks-server-credentials.json
node dist/index.js auth

3. 同じ環境変数を設定してサーバーを実行します（または、gcp-oauth.keys.json をプロジェクトのルートに配置し、既定値を使用します）。

以下の別名も使用できます。

用途	推奨	別名
OAuth クライアントキー	GTASKS_CREDENTIALS_PATH	GOOGLE_OAUTH_KEYS_PATH
保存済みトークン	GTASKS_TOKEN_PATH	GOOGLE_TASKS_CREDENTIALS_PATH

オプション C — ホーム設定ファイル

~/.gtasks-credentials.json を作成します。

{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "refreshToken": "your_refresh_token"
}

ツール

ツール	説明
search	タイトルまたはメモでタスクを検索します。taskListId は任意です。
list	タスクを一覧表示します（すべてのリスト、または taskListId で指定したリスト）。ページネーションに完全対応しています。
list_task_lists	タスクリストの名前と ID を一覧表示します。
list_with_tree	1 つのリストをツリー表示します（親子関係、位置順）。
move	並べ替え、ネスト／ネスト解除、リスト間の移動を行います。
create	タスクを作成します（title は必須、メモ／期限／taskListId は任意）。
update	タスクを部分更新します（指定したフィールドのみ変更されます）。
delete	タスクを削除します。
clear	リストから完了済みタスクを削除します。

使用例

show my task lists
list tasks in list <id>
search for tasks containing "meeting"
create a task named "Prepare presentation" due 2026-07-20
show the task tree for list <id>
move task <id> under parent <parentId>
mark task <id> completed

Docker

docker build -t gtasks-mcp .
docker run -i \
  -e GOOGLE_CLIENT_ID=your_client_id \
  -e GOOGLE_CLIENT_SECRET=your_client_secret \
  -e GOOGLE_REFRESH_TOKEN=your_refresh_token \
  gtasks-mcp

開発

npm install
npm run build
npm start

認証の確認／対話型ログイン：

npm run build
node dist/index.js auth

セキュリティに関する注意

• 更新トークンはパスワードと同様に扱ってください。
• 環境変数または Git の追跡対象外にした認証情報ファイルを使用してください。認証情報をコミットしないでください。
• 認証情報が漏えいした場合は、ローテーションしてください。

コントリビューター

• ArtyMcLabin — ページネーション、taskListId による絞り込み、list_task_lists、list_with_tree、move、ファイルベースの認証（#1）
• zcaceres — Google Tasks MCP サーバーのオリジナル作成者
• alvinjchoi — フォークの保守、Smithery/npm パッケージ化

CONTRIBUTORS.md を参照してください。

ライセンス

MIT