todoist-mcp

機能

• 完全なTodoist API統合: Todoist REST API v2へのフルアクセス、および自然言語を通じたTodoist Sync APIのサポート

• バッチ処理: クライアントは1つのリクエストで複数のタスクを処理可能

• 名前による検索: AIはIDの代わりに名前でタスク、プロジェクト、ラベルを検索可能

• タスク: 会話形式の言語を使用してタスクの作成、更新、完了、再開、移動、削除が可能

• プロジェクト: プロジェクトとセクションの作成および管理

• コメント: タスクやプロジェクトへのコメントの追加および管理

• ラベル: 個人用および共有ラベルの作成および管理

• スマートコンテキスト: 起動時に、サーバーの指示を通じてプロジェクトやラベルをAIに自動的に提供するため、追加のツール呼び出しは不要

• プロンプトサポート: クライアントに対してプロジェクトに関する情報を簡単に提供可能

Related MCP server: Notion API MCP Server

設定

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

Todoist APIトークンの取得方法

1. Todoistアカウントにログイン

2. 「設定」→「連携機能」に移動

3. 「開発者」セクションの下にあるAPIトークンを確認

使用方法

プラットフォーム設定の mcpServers に追加してください：

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

Codex — CLI:

codex mcp add todoist --env API_KEY=your_token -- npx -y todoist-mcp

または config.toml に追加:

[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]

[mcp_servers.todoist.env]
API_KEY = "your_todoist_api_token"

利用可能なツール

タスク

• get_tasks_list: プロジェクト、セクション、ラベル、またはIDによるフィルタリングでタスクを取得

• get_tasks_by_filter: Todoistのフィルタ言語（例: "today", "overdue", "P1 | P2", "#Work & @urgent"）を使用してタスクを取得

• 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_comments_list: プロジェクトやタスクのコメントを取得

• create_comments: 新しいコメントを作成

• get_comments: IDで特定のコメントを取得

• update_comments: コメントを更新

• delete_comments: コメントを削除

ラベル

• 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: プロジェクトのリストをセクションやパラメータとともにMarkdown形式で取得

使用例

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リポジトリでIssueを作成してください。