MCP Googletasks

🚀 Google タスク MCP サーバー

このモデルコンテキストプロトコル (MCP) サーバーは、Claude と Google タスクの間の架け橋として機能し、Claude を通じて直接タスクリストとタスクを管理できるようにします。

⚠️ 重要提示

このプロジェクトのすべてのコード（一部の修正を除く）は、Claude によって "vibe コーディング" という指示に基づいて生成されました。

✨ 主な機能

この 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 プロジェクトを作成し、API を有効にする

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成します。
3. "APIs & Services" > "Library" に移動します。
4. "Google Tasks API" を検索し、有効にします。
5. "APIs & Services" > "Credentials" に移動します。
6. "Create Credentials" > "OAuth Client ID" をクリックします。
7. OAuth 同意画面を設定します（個人使用の場合は External で構いません）。
8. アプリケーションの種類として、"Web アプリケーション" を選択します。
9. "http://localhost:3000" を承認済みのリダイレクト URI として追加します。
10. クライアント ID とシークレットを作成します。

2. Claude for Desktop を構成する

1. Claude for Desktop をインストールします。
2. Claude の設定ファイルを開きます。
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Google Tasks MCP サーバーの設定を追加します。

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
      }
    }
  }
}

パスと資格情報を自分のものに置き換えてください。

3. サーバーをビルドして実行する

1. 依存関係をインストールします。

npm install

2. サーバーをビルドします。

npm run build

3. Claude for Desktop を再起動します。

📚 ドキュメント

認証フロー

Google Tasks MCP サーバーを初めて使用するときは、以下の手順で認証を行います。

1. authenticate ツールを使用して、承認 URL を取得します。
2. ブラウザでその URL にアクセスし、Google アカウントでログインします。
3. 承認後、ブラウザページにコードが表示されます。
4. set-auth-code ツールとこのコードを使用して、認証を完了します。
5. これで、他のすべてのツールを使用して Google タスクとやり取りできます。

認証はセッションベースであり、サーバーを再起動すると失われます。サーバーを再起動するたびに、再度認証する必要があります。

要件

• Node.js 14 以上
• 最新バージョンの Claude for Desktop
• Google Cloud プロジェクトで Tasks API が有効になっていること

📷 スクリーンショット

📄 ライセンス

このプロジェクトはデモ用途のみです。自己責任で使用してください。