Todoist Mcp Server

Todoist MCP Server

Todoist API と Claude などの AI アシスタントを接続する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI アシスタントが Todoist のプロジェクト、セクション、タスク、ラベルを操作できるため、自然言語での会話を通じて生産性向上のためのワークフロー全体を管理できます。

Todoist MCP サーバーは、AI アシスタントと Todoist ワークスペースをつなぎ、会話形式のインターフェースを通じてプロジェクト、セクション、タスク、ラベルをシームレスに管理できるようにします。

目次

• 前提条件
• 使用方法
• MCP ツール
  • プロジェクト
  • セクション
  • タスク
  • ラベル
  • コメント
• ライセンス

前提条件

この MCP サーバーを使用するには、Todoist API トークンが必要です。

1. Todoist Developer Settings にアクセスします
2. API トークンをコピーします

使用方法

このサーバーを MCP クライアントで使用するには、次の設定を追加します。

{
  "mcpServers": {
    "todoist": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TODOIST_API_TOKEN=<your_api_token_here>",
        "ghcr.io/koki-develop/todoist-mcp-server:latest"
      ]
    }
  }
}

<your_api_token_here> を実際の Todoist API トークンに置き換えてください。

MCP ツール

このサーバーは、AI アシスタントが Todoist データを操作するために使用できる次のツールを提供します。

• プロジェクト
  • get_projects
  • get_project
  • create_project
  • update_project
  • delete_project
• セクション
  • get_sections
  • get_section
  • create_section
  • update_section
  • delete_section
• タスク
  • get_tasks
  • get_tasks_by_filter
  • get_task
  • create_task
  • update_task
  • delete_task
  • close_task
  • reopen_task
  • move_tasks_to_project
  • move_tasks_to_section
  • move_tasks_to_parent
• ラベル
  • create_label
  • update_label
  • get_label
  • get_labels
  • delete_label
• コメント
  • create_task_comment
  • create_project_comment
  • update_comment
  • get_task_comments
  • get_project_comments
  • delete_comment

プロジェクト

get_projects

認証済みユーザーがアクセスできるすべての Todoist プロジェクトを取得します。個人用プロジェクトとワークスペースプロジェクトの両方について、名前、色、お気に入りの状態、表示スタイル、階層情報などのメタデータを含む包括的なプロジェクト情報を返します。

get_project

一意の識別子を使って、特定の Todoist プロジェクトの詳細情報にアクセスします。設定、階層、整理に関する詳細を含む、プロジェクトの完全なメタデータを取得します。

create_project

設定をカスタマイズして、新しい Todoist プロジェクトを作成します。

update_project

既存の Todoist プロジェクトのプロパティを変更します。

delete_project

一意の識別子を指定して、Todoist プロジェクトを完全に削除します。この操作により、プロジェクトと、関連するすべてのタスク、セクション、コメントが削除されます。この操作は取り消せません。

セクション

get_sections

特定の Todoist プロジェクト内のすべてのセクションを取得します。名前、順序、作成日時と更新日時、ステータス情報などのメタデータを含む、包括的なセクション一覧を返します。セクションは、プロジェクト内での表示順に返されます。

get_section

固有の識別子を使って、特定の Todoist セクションの詳細情報にアクセスします。名前、プロジェクトの割り当て、順序、タイムスタンプ、ステータスフラグなど、完全なセクションメタデータを提供します。

create_section

タスクを整理するために、Todoist プロジェクト内に新しいセクションを作成します。セクションを使うと、プロジェクト内で関連するタスクを分類し、グループ化できます。

update_section

既存の Todoist セクションの名前を変更します。現在、更新できるのはセクション名のみです。

delete_section

固有の識別子を使って、Todoist セクションを完全に削除します。この操作によりセクションが削除され、そのセクション内にあるタスクはプロジェクトのメインエリアに移動されます。この操作は取り消せません。

タスク

get_tasks

柔軟なフィルタリングオプションを使って Todoist のタスクを取得します。内容、説明、プロジェクトの割り当て、期日、優先度、ラベル、完了ステータス、階層情報などのメタデータを含む、包括的なタスク一覧を返します。フィルターを指定しない場合、認証済みユーザーがアクセスできるすべてのタスクを返します。

get_tasks_by_filter

高度なフィルター構文を使って Todoist のタスクを取得します。複雑なタスク検索のために、Todoist の自然言語フィルター構文による強力なフィルタークエリに対応しています。一致するすべてのタスクを取得できるよう、ページネーションを自動的に処理します。

get_task

固有の識別子を使って、特定の Todoist タスクの詳細情報にアクセスします。内容、説明、プロジェクトとセクションの割り当て、期日情報、優先度、割り当てられたラベル、完了ステータス、親子関係、タイムスタンプなど、完全なタスクメタデータを提供します。

create_task

包括的な設定オプションを使って、新しい Todoist タスクを作成します。

update_task

既存の Todoist タスクのプロパティを変更します。

delete_task

固有の識別子を使って、Todoist タスクを完全に削除します。この操作により、タスクと関連するすべてのコメントおよび添付ファイルが削除されます。サブタスクがある場合は、それらも削除されます。この操作は取り消せません。

close_task

Todoist タスクを完了済みとしてマークします。この操作により、すべてのタスクデータと履歴を保持したまま、タスクが完了状態に移行します。必要に応じて、完了済みのタスクを後から再開できます。

reopen_task

以前に完了した Todoist タスクを再開し、アクティブな状態に戻します。この操作により、タスクは完了前の状態に復元されます。

move_tasks_to_project

複数のタスクを Todoist 内の別のプロジェクトに移動します。このツールを使うと、複数のタスクのプロジェクト割り当てを同時に変更し、効率的に一括で再編成できます。指定したすべてのタスクが現在の場所から対象のプロジェクトに移動されます。

move_tasks_to_section

複数のタスクを Todoist 内の別のセクションに移動します。このツールを使うと、複数のタスクのセクション割り当てを一度に変更し、一括で整理できます。指定したすべてのタスクが現在の場所から対象のセクションに移動されます。

move_tasks_to_parent

複数のタスクを Todoist 内の別のタスクのサブタスクにします。このツールを使うと、複数のタスクを指定した親タスクの子タスクにして、タスクの階層を作成できます。指定したすべてのタスクが、対象の親タスクのサブタスクに変換されます。

ラベル

create_label

名前、色、表示順、お気に入りステータスなどのプロパティを設定して、新しい個人用ラベルを作成します。ラベルを使うと、プロジェクトをまたいでタスクを分類し、整理できます。

update_label

既存の個人用ラベルのプロパティを変更します。ラベル名、色、表示順、お気に入りの状態を変更できます。ラベル ID 以外のすべてのパラメーターは省略可能なため、変更したいプロパティだけを更新できます。

get_label

一意の ID を指定して、特定の個人用ラベルを取得します。名前、色、順序、お気に入りの状態など、すべてのメタデータを含みます。タスクの整理やフィルタリングに使用できるよう、指定したラベルの詳細情報を返します。認証済みユーザーに属する有効なラベル ID が必要です。

get_labels

認証済みユーザーがアクセスできるすべての個人用ラベルを取得します。名前、色、順序、お気に入りの状態など、すべてのメタデータを含みます。タスクの整理やフィルタリングに使用できるラベルの包括的な一覧を返します。このツールはラベル情報への読み取り専用アクセスを提供し、ページネーションを自動的に処理します。

delete_label

一意の識別子を指定して、個人用ラベルを完全に削除します。警告：この操作は元に戻せません。 関連付けられたすべてのタスクからラベルが自動的に削除されます。削除したラベルは復元できないため、注意して使用してください。

コメント

create_task_comment

特定の Todoist タスクにコメントを追加します。リッチテキストのコンテンツと、任意のファイル添付をサポートしています。作成に成功すると、すべてのメタデータを含むコメントオブジェクト全体を返します。

create_project_comment

特定の Todoist プロジェクトにコメントを追加します。リッチテキストのコンテンツと、任意のファイル添付をサポートしています。作成に成功すると、すべてのメタデータを含むコメントオブジェクト全体を返します。

update_comment

Todoist の既存のコメントの内容を更新します。タスクやプロジェクトに付けられたコメントのテキスト内容を変更できます。投稿時刻、作成者、添付ファイルなど、コメントのメタデータは保持されます。 現在の内容に更新されたコメントオブジェクトを返します。

get_task_comments

特定の Todoist タスクに関連付けられたすべてのコメントを取得します。内容、作成者情報、タイムスタンプ、ファイル添付、リアクションなどのメタデータを含む、包括的なコメント一覧を返します。コメントは時系列順に返されます。タスクのすべてのコメントを取得できるよう、ページネーションを自動的に処理します。

get_project_comments

特定の Todoist プロジェクトに関連付けられたすべてのコメントを取得します。内容、作成者情報、タイムスタンプ、ファイル添付、リアクションなどのメタデータを含む、包括的なプロジェクトレベルのコメント一覧を返します。コメントは時系列順に返されます。プロジェクトのすべてのコメントを取得できるよう、ページネーションを自動的に処理します。

delete_comment

一意の識別子を指定して、コメントを完全に削除します。この操作により、関連付けられたタスクまたはプロジェクトからコメントが削除されます。この操作は元に戻せないため、注意して使用してください。 削除の成功確認または失敗通知を返します。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

Copyright (c) 2025 Koki Sato