tasklist-port

tasklist-port

Todoist のタスクを MCP ツールとして扱い、Todoist REST API v1 と通信します。 tasklist-port は、Todoist MCP サーバーの主要機能を新しい名前でクリーンルーム方式で再構築したものです。コードは一から作成し、ブランド表記はコピーしていません。

ツール（コア機能の一部、12 個）

list_tasks、get_task、create_task、update_task、close_task、 reopen_task、delete_task、list_projects、get_project、 create_project、list_labels、list_sections。

この機能には含まれないもの：コメント、共有ラベル、共同作業者／共有、 リマインダー、アクティビティログ、完了済みアイテムの履歴、プロジェクトの 共同作業者管理、ユーザー／生産性の統計、Sync API の差分同期、 バックアップ、テンプレートのインポート／エクスポート、クイック追加解析エンドポイント。

セットアップ

Todoist で API トークンを作成し（設定 → インテグレーション → 開発者）、 次のように設定します。

export TODOIST_API_TOKEN=0123456789abcdef...

必要に応じて、TODOIST_API_BASE_URL で API のベース URL を上書きできます （デフォルトは https://api.todoist.com/api/v1）。トークンが設定されていない場合、 すべてのツール呼び出しは、不足している変数名を示すエラーで失敗します。注： Todoist のリストエンドポイントは、バージョンによって配列そのもの、または {results:[...]} 形式のエンベロープを返します。tasklist-port は解析済みの ペイロードをそのまま返します。

CLI

npx @reneturcios/tasklist-port list_tasks '{"project_id":"p1"}'
npx @reneturcios/tasklist-port mcp        # stdio MCP server

各ツール名はサブコマンドで、引数として 1 つの JSON オブジェクトを受け取ります。

MCP クライアントの設定

{
  "mcpServers": {
    "tasklist-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tasklist-port", "mcp"],
      "env": { "TODOIST_API_TOKEN": "0123456789abcdef..." }
    }
  }
}

Docker

docker run -i -e TODOIST_API_TOKEN ghcr.io/cloudcorprecords/tasklist-port

開発

npm install
npm run build
npm test

ライセンス

MIT