Google Tasks MCP

Google Tasks MCP

英語 | ロシア語

A1 Google Tasks MCP を使うと、AI アプリから自然な言葉で Google Tasks を管理できます。プロジェクトをタスクリストとして計画し、期限やメモを付けてサブタスクに分割し、作業を完了済みにして、すべてを整理できます。

Google アカウントで Google Tasks API を使用します。取り消し可能な完了と恒久的な削除を区別し、Tasks API ではすべての ToDo 機能が使えるかのように見せるのではなく、その制限を明示します。

• 21 個のツール。 タスクリストやタスクの一覧表示、作成、更新、タスクの移動、完了状態の管理、完了済み作業の整理、専用ツールがない場合の API への直接アクセスができます。
• 会話から接続できます。 「Google Tasks に接続して」と伝えると、サーバーが OAuth クライアントの設定を案内し、PKCE を使って 127.0.0.1 で Google のリダイレクトを受け取り、トークンを自身で保持します。設定ファイルも再起動も不要です。
• 完了は取り消せますが、削除は取り消せません。 complete_task には取り消し用の reopen_task があります。削除ツールは別に用意され、破壊的操作として明示されています。
• 期限については正確に扱います。 API が保存するのはカレンダーの日付のみです。サーバーが時刻まで指定できるかのように装うことはありません。時刻はメモに記載してください。
• Google の権限は最小限です。 tasks スコープのみを使用し、Drive、Calendar、Gmail へのアクセス権はありません。

まずは読み取り専用の質問から始めましょう。

デフォルトのリストにあるタスクリストと、金曜日より前が期限のすべてのタスクを表示してください。

サーバーに接続する · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： 「Website launch」リストで未完了のものと、今週が期限のものを教えてください。

アシスタント： 未完了のタスクを、期限、メモ、サブタスクとともに表示します。何も変更されません。

あなた： 「Marketing」のサブタスクとして、「Send the launch announcement」というタスクを金曜日が期限になるよう追加してください。

アシスタント： 対象のリスト、親タスク、追加予定のタスクを表示し、作成前に確認を求めます。

あなた： 確認します。

アシスタント： 金曜日を期限とするサブタスクを作成します。別途依頼しない限り、何かを完了済みにしたり削除したりすることはありません。

目次

• クイックスタート
• 依頼できること
• タスクの変更方法
• 変更できる内容
• アクセス権の取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20 以降と Google アカウントが必要です。インストール時に認証情報は不要です。サーバーは会話中に接続します。

1. AI アプリにサーバーを追加します。
2. 「connect Google Tasks」と伝えます。アシスタントが、設定ファイルを編集せずにOAuth クライアントの作成とアクセスの承認を案内します。
3. 上記の読み取り専用の質問をします。

codex mcp add google-tasks \
  -- npx -y mcp-google-tasks@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-tasks \
  -- npx -y mcp-google-tasks@latest

claude mcp list

{
  "mcpServers": {
    "google-tasks": {
      "command": "npx",
      "args": ["-y", "mcp-google-tasks@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-tasks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tasks@latest"]
    }
  }
}

{
  "servers": {
    "google-tasks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tasks@latest"]
    }
  }
}

できること

リストを確認して、一日の予定を立てる

• タスクリストと各リスト内の未完了タスクを表示してください。
• デフォルトのリストで今週が期限のタスクは何ですか？サブタスクも含めてください。
• 昨日から何が変わりましたか？完了済みおよび非表示のタスクも含めてください。

作業を作成して整理する

• デザイン、コンテンツ、QA のタスクを含む「Website launch」リストを作成してください。
• 「Marketing」タスクの下にネストした、メモ付きで金曜日が期限のタスクを追加してください。
• タスクをリストの先頭、別のタスクの下、または別のリストに移動してください。

完了状況を追跡する

• レビュータスクを完了にしてください。作業が再開したら、未完了に戻してください。
• 完了したすべてのタスクを一度にリスト表示から非表示にしてください。
• 以前に非表示にしたタスクを表示してください。

タスクの変更方法

1. タスクはタスクリストに保存されます。すべてのアカウントには、特別な ID @default で指定する組み込みのデフォルトリストがあります。create_tasklist でリストを追加できます。
2. タスクにはタイトル、メモ、日付のみの期限日があります。API は時刻部分を破棄するため、時刻はメモに記載してください。
3. 並べ替えとネストの変更は move_task でのみ行えます。API の position フィールドは読み取り専用です。
4. タスクの完了は取り消せます。reopen_task で再開できます。タスクやリストを削除すると元に戻せません。また、リストを削除すると、そのリスト内のすべてのタスクも削除されます。

API では繰り返しタスクを作成できません。Google ドキュメントまたは Chat から割り当てられたタスクは読み取れますが、作成したり別のリストに移動したりすることはできません。また、そのタスクを削除すると、元のドキュメントからも削除されます。サーバー側の検索や並べ替えには対応していません。サーバーがタスクの一覧を取得し、AI クライアントが絞り込みます。

変更できる内容

確認プロンプトは AI クライアントが制御します。サーバーは読み取り、書き込み、破壊的なツールに印を付けるため、クライアントは内容の確認と実際の変更を区別できます。

アクセスの取得

Google Tasks では OAuth 2.0 が必要です。API キーだけでは使えません。アクセス方法は 2 つあります。1 つ目は設定ファイルが不要です。

チャットから接続する（推奨）

「Google Tasks に接続して」と伝えると、アシスタントが一緒に手順を進めます。

1. setup_instructions でチェックリストが表示されます。Google Cloud プロジェクトの作成または選択、Google Tasks API の有効化、同意画面の設定、Desktop app OAuth クライアントの作成を行います。
2. そのクライアントの JSON（「Download JSON」）をダウンロードし、アシスタントにそのパスを伝えます。set_client により、ファイルは所有者のみがアクセスできるよう保存されます。シークレットが会話に送信されることはありません。
3. start_login から Google の同意リンクが返されます。このマシン上でリンクを開いて承認してください。コードはチャットを経由せず、127.0.0.1 上の一度限りのリスナーに戻されます（PKCE）。
4. finish_login がコードを交換し、トークンを ~/.config/mcp-google-tasks/credentials.json（モード 0600）に保存してから、実際の Google Tasks API 呼び出しでトークンを検証します。これにより、API がまだ無効になっている場合もその場で検出されます。

トークンは呼び出しのたびに再読み込みされるため、AI アプリを再起動しなくても、接続後すぐに使えます。auth_status で接続状況を確認でき、logout で接続を取り消して認証情報を削除できます。

環境変数（CI、無人インストール）

1. Google Cloud プロジェクトを作成または選択し、Google Tasks API を有効にします。

2. OAuth 同意画面を設定し、Desktop app OAuth クライアントを作成します。

3. タスクを所有する Google アカウントを認証します。OAuth 2.0 Playground では、Use your own OAuth credentials を有効にすると、リフレッシュトークンを取得できます。

4. 次のスコープをリクエストします。

   https://www.googleapis.com/auth/tasks
   

テストモードの OAuth リフレッシュトークンは、7 日後に期限切れになることがあります。長期間アクセスする必要がある場合は、OAuth アプリを公開するか、Workspace ドメイン内の内部アプリを使用してください。クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。

設定

すべての変数は省略可能です。いずれも指定しない場合、サーバーはチャットから接続します。

* OAuth の 3 つの値、またはアクセストークンのいずれかを指定してください。

認証情報がなくてもサーバーは起動して MCP のハンドシェイクを完了しますが、最初のツール呼び出しは、設定すべき変数名と再起動を促すメッセージとともに失敗します。

データ、制限、バックグラウンド処理

• リクエストは Google Tasks に送信されます。 ローカルサーバーは Google OAuth トークンを更新し、Tasks API を呼び出します。匿名テレメトリーには、インストール ID、パッケージのバージョン、AI クライアントとプラットフォームのバージョン、ツール名が含まれます。OAuth トークン、タスクの内容、ツールの引数、プロンプトは含まれません。オプトアウトするには、ASKADS_TELEMETRY=0 を設定してください。
• Google には 1 日あたりの割り当て量があります。 Tasks API のプロジェクトごとの猶予枠は、1 日あたり 50,000 クエリです。429 が返された場合、サーバーはバックオフを行います。また、読み取りではネットワークエラーと 5xx エラーの後に再試行しますが、書き込みは不確実な失敗の後に再実行されません。代わりに get_task で結果を確認してください。
• バックグラウンドでのポーリングはありません。 サーバーは呼び出されたときのみ実行されます。list_tasks は updated_min フィルターを使った差分同期に対応しているため、スケジュール済みタスクを持つ AI アプリは、すべてを再読み込みせずに定期的に変更を確認できます。

技術ドキュメント

• MCP 機能カタログ — 各ツールのタスク別ページ。
• すべてのツールと入力
• 開発ドキュメント
• 公開に関するドキュメント
• Google Tasks API リファレンス

サポート

バグを見つけた場合や、必要なシナリオがある場合は、issue を作成するか、Telegram でご連絡ください。

最後までご覧いただき、ありがとうございます！