Todoist MCP Server

機能

• Todoist API との完全な連携：Todoist REST API v2 の全機能を利用でき、自然言語を通じて Todoist Sync API にも対応します
• バッチ処理：クライアントは 1 回のリクエストで複数のタスクを処理できます
• 名前で検索：AI は ID ではなく名前でタスク、プロジェクト、ラベルを検索できます
• タスク：会話形式の指示でタスクの作成、更新、完了、再開、移動、削除ができます
• プロジェクト：プロジェクトとセクションを作成、管理できます
• コメント：タスクやプロジェクトにコメントを追加、管理できます
• ラベル：個人用ラベルと共有ラベルを作成、管理できます
• スマートコンテキスト：起動時に、サーバーの指示を通じてプロジェクトとラベルを AI に自動提供します。追加のツール呼び出しは不要です
• プロンプト対応：プロジェクトに関する情報をクライアントに簡単に提供できます

設定

この 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" }
}

プラットフォーム	設定
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json（macOS）、%APPDATA%\Claude\（Windows）
Claude Code	.mcp.json — claude mcp add --transport stdio --scope project --env API_KEY=token todoist -- npx -y todoist-mcp
Cursor	~/.cursor/mcp.json または .cursor/mcp.json
Codex	~/.codex/config.toml または .codex/config.toml — 以下の例を参照
Gemini CLI	~/.gemini/settings.json — gemini mcp add -e API_KEY=token todoist npx -y todoist-mcp

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 形式で取得

使用例

Claude などの AI アシスタントに、次のような質問をしてみましょう。

"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 リポジトリでイシューを登録してください。