Skip to content

toru-takagi/togello

v0.1.0ISC

Manage personal tasks, calendar memos, and activity logs with Togello.

Togello Agent Plugin

Togello logo

Togelloの公開MCPへ接続し、個人のTODO・予定参照・日別メモ・活動記録をAIから扱うためのPluginである。

Agent Plugins 1.0.0の共通形式を使用する。独自のSkillや実行スクリプトは含まない。

現在の状態

Marketplaceには未申請である。2026-09-07にmacOSのCursorで、ローカルPluginの認識、OAuth認可の完了、Streamable HTTP接続、12ツールの認識、日本の現在日時の取得を確認した。

この検証はローカル配置での確認であり、Marketplace経由のインストール、全ツールの操作、トークン期限切れ後の自動更新、他クライアントでの互換性までを保証するものではない。申請用の説明文と検証範囲はMarketplace申請資料を参照する。

接続先と認証

  • MCP: https://mcp.togello.com/mcp
  • Transport: Streamable HTTP
  • OAuth issuer: https://togello.api.toru-takagi.dev
  • 利用にはTogelloアカウントが必要である。
  • Google Calendarの予定参照には、Togello側でのGoogle Calendar連携が必要である。

認証はクライアントが管理する。Agent Plugins 1.0.0には共通のOAuth設定フィールドがないため、このPluginには接続先のみを記載する。クライアントが提示するTogelloの認可画面で権限を確認して接続する。認可画面が出ない場合は、クライアントのリモートMCP・OAuth対応を確認する。

トークン、クライアントシークレット、個人のタスクやメモを、このリポジトリのファイルに保存しない。

Cursorでのローカル検証手順

以下はCursor公式ドキュメントとローカルでの実機確認に基づく手順である。配置方法はCursor 3.9.16で確認した。

  1. このリポジトリをローカルに取得する。
  2. ~/.cursor/plugins/local/togello/に、plugin.jsonmcp.jsonが直下になるよう実体ファイルをコピーする。リポジトリへのシンボリックリンクは使用しない。Cursor 3.9.16は、この配置先の外を指すリンクを拒否する。
  3. Cursorを再起動するか、Developer: Reload Windowを実行する。
  4. CustomizeまたはチャットのMCP選択で、Plugins由来のTogelloが認識されていることを確認する。同名のUser由来MCPと混同しない。
  5. Customize → Togello → Configure togelloでAuthenticateを押し、新しく開いた認可画面でログイン・権限確認を進める。「Open Cursor」が表示された場合はCursorへ戻り、LocalがConnectedになっていることを確認する。
  6. Agentモードの新規チャットで「Togello Pluginのget-japan-current-timeだけを1回呼び出して。その他のデータの取得・変更はしないで」と依頼し、結果を確認する。Askモードではこの検証を行わない。検証時は、自動で汎用デモを開始するTry in Chatではなく、自分で検証指示を入力する。

Add → From Local Repoは、この単体Pluginを直接追加する手順として使用しない。Cursor 3.9.16ではMarketplace manifestを要求するため、上記のローカル配置を使用する。コピー元を修正した場合は配置先にもコピーし直す。

ログイン後にlocalhost:8787/callbackへ接続できない場合は、Cursor側の認証待受が終了している可能性がある。Cursorの状態を確認し、未接続ならAuthenticateから新しい認証を開始する。古い認可ページやcallback URLを再利用せず、新しく開いたページで続ける。URLのクエリに含まれる認証コードなどをサポートへ送らない。

組織設定でローカルPluginの読み込みが禁止されている場合は、その設定に従う。他のクライアントでは、Agent Plugins、Streamable HTTP、OAuthへの対応と導入手順を個別に確認する。

できること

領域操作
TODO一覧取得、作成、更新、完了などの状態変更
カテゴリ一覧取得
予定連携Google Calendarの予定と、予定日時を持つTODOの参照
日別メモ指定日の取得、更新、クリア
活動記録活動項目・ログの取得、開始、完了
時刻日本の現在日時の取得

Gatherの作成、複数人の日程調整、Google Calendarへの予定作成は提供しない。カレンダー取得ツールには任意期間を指定する入力がない。

依頼例

以下は公開MCPの機能に基づく依頼例である。今回のPlugin実機検証は日本時刻の取得までであり、以下の個人データの取得・変更は検証範囲に含めていない。

  • 「Togelloの未完了タスクを一覧にして」
  • 「Togelloの予定と未完了タスクを確認し、今日の作業順を提案して。データは変更しないで」
  • 「Togelloに『リリース手順を確認する』というTODOを作って」
  • 「Togelloの2026-09-06のカレンダーメモを表示して」
  • 「Togelloの活動項目と、現在進行中の活動ログを確認して」

TODOの作成・更新、日別メモの更新、活動ログの開始・完了は、Togello内のデータを変更する。日別メモの更新は本文の置換であり、空の内容を指定するとクリアされる。活動ログを開始するには既存の活動項目が必要である。

データとサポート

Pluginは既存のリモートMCPに接続する設定を配布する。実際に利用可能なツールや入力項目は、接続先とクライアントから取得される定義に従う。

このPluginの設定と文書はISC Licenseで提供する。assets/togello-icon-512.pngはISC Licenseの対象外である。Togelloサービス本体のコードやTogelloの名称・ロゴの権利を許諾するものではない。