Gtasks MCP

🚀 谷歌任务 MCP サーバー

このMCPサーバーはGoogle Tasksと統合されており、タスクの一覧表示、読み取り、検索、作成、更新、削除を行うことができます。

✨ 主な機能

ツール

• search

  • Google Tasks内でタスクを検索します。
  • 入力：query（文字列）：検索クエリ
  • 一致するタスクとその詳細情報を返します。

• list

  • Google Tasks内のすべてのタスクを一覧表示します。
  • オプション入力：cursor（文字列）：ページングカーソル
  • すべてのタスクのリストを返します。

• create

  • Google Tasks内に新しいタスクを作成します。
  • 入力：
    • taskListId（文字列、オプション）：タスクリストID
    • title（文字列、必須）：タスクタイトル
    • notes（文字列、オプション）：タスクメモ
    • due（文字列、オプション）：期限日
  • タスク作成の確認を返します。

• update

  • Google Tasks内の既存のタスクを更新します。
  • 入力：
    • taskListId（文字列、オプション）：タスクリストID
    • id（文字列、必須）：タスクID
    • uri（文字列、必須）：タスクURI
    • title（文字列、オプション）：新しいタスクタイトル
    • notes（文字列、オプション）：新しいタスクメモ
    • status（文字列、オプション）：新しいタスクステータス（"needsAction" または "completed"）
    • due（文字列、オプション）：新しい期限日
  • タスク更新の確認を返します。

• delete

  • Google Tasks内のタスクを削除します。
  • 入力：
    • taskListId（文字列、必須）：タスクリストID
    • id（文字列、必須）：タスクID
  • タスク削除の確認を返します。

• clear

  • Google Tasksのタスクリストから完了したタスクをクリアします。
  • 入力：taskListId（文字列、必須）：タスクリストID
  • クリアされたタスクの確認を返します。

リソース

サーバーはGoogle Tasksのリソースへのアクセスを提供します。

• Tasks (gtasks:///<task_id>)
  • Google Tasks内の単一のタスクを表します。
  • タイトル、ステータス、期限日、メモ、その他のメタデータを含むタスクの詳細情報の読み取りをサポートします。
  • 提供されたツールを使用して、一覧表示、読み取り、作成、更新、削除を行うことができます。

🚀 クイックスタート

1. 新しいGoogle Cloudプロジェクトを作成する
2. Google Tasks APIを有効にする
3. OAuth同意画面を設定する（テスト時は「内部」で構いません）
4. スコープ https://www.googleapis.com/auth/tasks を追加する
5. デスクトップアプリタイプのOAuthクライアントIDを作成する
6. クライアントのOAuthキーJSONファイルをダウンロードする
7. キーファイルを gcp-oauth.keys.json にリネームし、このリポジトリのルートディレクトリに配置する（つまり gcp-oauth.keys.json）

npm run build または npm run watch でビルドすることを確認してください。

Smitheryを通じたインストール

Smithery を通じてGoogle Tasksサーバーを自動インストールするには：

npx -y @smithery/cli install @zcaceres/gtasks --desktop

使用方法

• サーバーバイナリを gtasks-mcp と命名し、デフォルトの実行可能パスに配置します。
• コマンドラインから gtasks-mcp を実行します。
• http://localhost:8080 にアクセスしてWebインターフェイスを使用します。

💻 使用例

基本的な使用法

# タスクを作成する
curl -X POST http://localhost:8080/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"プロジェクトを完了する","notes":"金曜日までに完了する必要があります"}'

# すべてのタスクを一覧表示する
curl http://localhost:8080/api/tasks

# タスクのステータスを更新する
curl -X PUT http://localhost:8080/api/tasks/123 \
  -H "Content-Type: application/json" \
  -d '{"status":"completed"}'

📦 インストール

依存関係

• Node.jsとnpmがインストールされていることを確認してください。

推奨されるコマンドラインツール

• jq ：JSONデータを処理するため
• curl ：HTTPリクエストを送信するため

📚 ドキュメント

その他の注意事項

• Google Cloudプロジェクトで課金が有効になっていることを確認してください。
• 依存関係のインストールには npm install を使用してください。
• 使用する前に完全なドキュメントとサンプルを読んでください。