todoist-mcp

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides full access to the Todoist REST API v2, enabling task management (create, update, close, reopen, delete), project management, section handling, comment management for tasks and projects, and label management through natural language interactions.

特徴

完全なTodoist API統合: Todoist REST API v2の完全なアクセスと、自然言語によるTodoist Sync APIのサポート
バッチ処理: クライアントは単一のリクエストで複数のタスクを処理できます
名前で検索: AIはIDではなく名前でタスク、プロジェクト、ラベルを検索できます
タスク: 会話言語を使用してタスクを作成、更新、閉じる、再開、移動、削除します
プロジェクト: プロジェクトとセクションの作成と管理
コメント: タスクやプロジェクトにコメントを追加、管理します
ラベル: 個人用ラベルと共有ラベルの作成と管理
迅速なサポート：プロジェクトに関する情報をクライアントに簡単に提供できます

構成

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

Todoist APIトークンを取得する

Todoistアカウントにログイン
設定→統合へ移動
「開発者」の下でAPIトークンを見つけます

Claude Desktopでの使用

claude_desktop_config.jsonに追加します:

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

利用可能なツール

タスク

get_tasks_list : プロジェクト、セクション、ラベルなどでオプションのフィルタリングを行ってタスクを取得します。
create_tasks : さまざまな属性を持つ新しいタスクを作成する
get_tasks : IDまたは名前で特定のタスクを取得する
update_tasks : 既存のタスクを更新する
close_tasks : タスクを完了としてマークする
reopen_tasks : 完了したタスクを再開する
delete_tasks : タスクを削除する
move_tasks : タスクを別のプロジェクトまたはセクションに移動する

プロジェクト

get_projects_list : すべてのプロジェクトを取得する
create_projects : 新しいプロジェクトを作成する
get_projects : IDまたは名前で特定のプロジェクトを取得する
update_projects : 既存のプロジェクトを更新する
delete_projects : プロジェクトを削除する
get_collaborators : プロジェクトのすべての共同作業者を取得する
move_projects : プロジェクトを別の場所またはサブプロジェクトに移動する

セクション

get_sections_list : すべてのセクションを取得するか、プロジェクトごとにフィルタリングする
create_sections : 新しいセクションを作成する
get_sections : IDまたは名前で特定のセクションを取得する
update_sections : セクションを更新する
delete_sections : セクションを削除する

ラベル

get_labels_list : すべての個人ラベルを取得する
create_labels : 新しい個人ラベルを作成する
get_labels : IDまたは名前で個人ラベルを取得する
update_labels : 個人ラベルを更新する
delete_labels : 個人ラベルを削除する
get_shared_labels : すべての共有ラベルを取得する
rename_shared_labels : 共有ラベルの名前を変更する
remove_shared_labels : 共有ラベルを削除する

ユーティリティ

utils_get_colors : プロジェクト、ラベル、フィルターで使用可能な色を取得します。

プロンプト

projects_list : セクションとパラメータを含むプロジェクトのリストをマークダウン形式で取得します。

使用例

AI アシスタント (Claude など) に次のような質問をします。

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

発達

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

問題とサポート

問題が発生した場合やサポートが必要な場合は、GitHub リポジトリで問題を報告してください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Todoist REST API v2 を完備し、タスク、プロジェクト、セクション、コメント、ラベル管理をサポートする Todoist Sync API 統合をサポート