mcpField
T
todoist

todoist

github.com/steveclarke生産性3643 回インストール今日更新
リポジトリ

todoist について

todoistは、AIクライアントからTodoistを操作するためのMCP連携を説明するスキルです。API tokenとOAuthの接続方法に加え、タスク検索・作成・更新・完了やプロジェクト操作のツールを紹介します。

主な機能

  1. 01API tokenとOAuthの設定方法
  2. 02テキスト・プロジェクト・日付でタスク検索
  3. 03タスクの作成・更新・完了
  4. 04プロジェクト・セクション・コメントの管理
  5. 05接続問題のトラブルシューティング

活用シーン

  1. 01今日のタスクと期限超過タスクを確認
  2. 02プロジェクト内でタスクを作成・整理
  3. 03タスク内容を変更、または完了にする

MCP 対応

Todoist MCP サーバーは、タスク、プロジェクト、セクション、コメントを操作するツールをMCPクライアントに公開します。API tokenを使うNPX設定、またはHTTP OAuthで接続できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/steveclarke/dotfiles --skill todoist

インストール後、Claude Code で/todoistを入力して読み込まれたか確認します。

詳細

Todoist MCP 統合

セットアップ

Todoist MCP サーバーの設定方法は 2 つあります。日常的な使用には、API トークンを使う NPX 版をおすすめします。

オプション 1：API トークンを使う NPX（推奨）

このバージョンでは Todoist API トークンを使用し、再認証は必要ありません。定期的に使用する場合に最適です。

1. API トークンを取得します：

2. ~/.claude.json の最上位に追加します：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@doist/todoist-ai"],
      "env": {
        "TODOIST_API_KEY": "your-api-token-here"
      }
    }
  }
}

重要： 環境変数は TODOIST_API_TOKEN ではなく、TODOIST_API_KEY にする必要があります。

3. 新しい設定を反映するため、Claude Code を再起動します。

オプション 2：OAuth を使う HTTP（代替）

このバージョンでは OAuth を使用し、定期的な再認証が必要です（セッションは約 1 時間後に期限切れになります）。トークンを保存したくない場合に便利です。

claude mcp add --transport http todoist https://ai.todoist.net/mcp

Claude Code で /mcp を実行して MCP パネルを開きます。Todoist をクリックして、OAuth フローを完了します。

注： OAuth セッションは頻繁にタイムアウトします。接続エラーが発生した場合は、/mcp から再認証してください。

トラブルシューティング

MCP に「failed」と表示される、または接続できない場合：

  1. 環境変数が TODOIST_API_TOKEN ではなく TODOIST_API_KEY になっていることを確認します
  2. Todoist の開発者向け設定で API トークンを再生成します。古いトークンは期限切れになっている可能性があります
  3. 設定を変更した後、Claude Code を再起動します
  4. mcp__todoist__user-info で接続を確認します

利用可能な MCP ツール

すべてのツールには mcp__todoist__ という接頭辞が付きます：

ツール用途
find-tasksテキスト、プロジェクト、セクション、ラベル、担当者でタスクを検索
find-tasks-by-date指定した期間のタスクを取得（今日と期限超過のタスクには startDate: "today" を使用）
add-tasks詳細なオプションを指定して、1 つ以上のタスクを作成
update-tasks既存のタスクを変更（移動、日付、優先度、説明、担当者の割り当て）
complete-tasksタスクを完了としてマーク
find-projectsプロジェクトを一覧表示または検索
find-sectionsプロジェクト内のセクションを一覧表示
get-overviewすべてのプロジェクト、または特定のプロジェクトの Markdown 概要
add-projects新しいプロジェクトを作成
add-sectionsプロジェクト内にセクションを作成
add-commentsタスクまたはプロジェクトにコメントを追加
find-commentsタスクまたはプロジェクトのコメントを取得
searchタスクとプロジェクトを全文検索
user-infoユーザーの詳細、タイムゾーン、目標を取得

タスク作成のベストプラクティス

口頭で説明された内容からタスクを作成する場合：

  1. 簡潔で実行可能なタイトルを抽出します — 元のテキストをそのまま貼り付けないでください
  2. 説明に背景情報を含めます —「なぜ」、理由、受け入れ条件を記載します
  3. 情報を漏らさないでください — 話された内容をすべて（タイトルまたは説明に）記録します
  4. 命令形を使います —「Wade に連絡する」であり、「Wade に連絡している」ではありません
MCP タスクのオプション
content: "Task title" (required)
description: "Additional details"
dueString: "tomorrow at 5pm" (natural language)
priority: "p1" | "p2" | "p3" | "p4" (p1 = highest)
projectId: "<project-id>" or "inbox"
sectionId: "<section-id>"
labels: ["label1", "label2"]
duration: "2h" | "90m" | "2h30m"
responsibleUser: "<name>" (for shared projects)

よく使う操作

今日のタスクを一覧表示

find-tasks-by-date で startDate: "today" を指定します。期限超過の項目も含まれます。

プロジェクト内のタスクを一覧表示

find-tasks に projectId を指定します。受信トレイには "inbox" を使用するか、find-projects からプロジェクト ID を取得します。

タスクを移動

update-tasks で projectId に移動先のプロジェクト ID を設定します。

タスクを割り当て（共有プロジェクト）

update-tasks で responsibleUser を指定します。注：タスクが受信トレイにある間は割り当てできません。先に移動してから割り当ててください。

簡易概要

すべてのプロジェクトを表示するには、パラメーターなしで get-overview を実行します。特定のプロジェクトとそのタスクを表示するには、projectId を追加します。

移行に関する注意

以前の CLI ツール（Homebrew 経由の todoist コマンド）には信頼性の問題がありました。移動が機能せず、同期も不安定でした。Doist 公式の MCP サーバーをおすすめします。

CLI がまだインストールされている場合：

brew uninstall todoist

コメント

Markdown 対応