Todoist MCP Server

Todoist MCP サーバー

Claude と Todoist を連携し、自然言語によるタスク管理を可能にする MCP（Model Context Protocol）サーバーの実装です。このサーバーを使うと、日常的な言葉で Claude から Todoist のタスクを操作できます。

機能

• 自然言語によるタスク管理：日常的な言葉でタスクの作成、更新、完了、削除ができます
• スマートなタスク検索：部分一致する名前でタスクを検索できます
• 柔軟な絞り込み：期限、優先度、その他の属性でタスクを絞り込めます
• 詳細なタスク情報：説明、期限、優先度に対応しています
• 直感的なエラー処理：ユーザー体験を向上させる明確なフィードバックを提供します

インストール

Smithery 経由でインストール

Smithery 経由で Todoist MCP Server を Claude Desktop に自動的にインストールするには：

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

手動インストール

npm install -g @abhiz123/todoist-mcp-server

ツール

todoist_create_task

さまざまな属性を指定してタスクを作成します：

• 必須：content（タスク名）
• 任意：description、期限、優先度（1〜4）
• 例：「『チームミーティング』というタスクを、説明を『週次の同期』、期限を明日にして作成」

todoist_get_tasks

タスクを取得し、絞り込みます：

• 期限、優先度、またはプロジェクトで絞り込み
• 自然言語による日付の絞り込み
• 結果数の上限を任意で指定
• 例：「今週が期限の優先度が高いタスクを表示」

todoist_update_task

自然言語検索を使って既存のタスクを更新します：

• 部分一致する名前でタスクを検索
• タスクの任意の属性（内容、説明、期限、優先度）を更新
• 例：「ミーティングのタスクの期限を次の月曜日に変更」

todoist_complete_task

自然言語検索を使ってタスクを完了済みにします：

• 部分一致する名前でタスクを検索
• 完了状態を確認
• 例：「ドキュメント作成のタスクを完了済みにする」

todoist_delete_task

自然言語検索を使ってタスクを削除します：

• 名前でタスクを検索して削除
• 確認メッセージ
• 例：「PR レビューのタスクを削除」

セットアップ

Todoist API トークンの取得

1. Todoist アカウントにログインします
2. 設定 → インテグレーションに移動します
3. 「Developer」で API トークンを確認します

Claude Desktop での使用

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

使用例

タスクの作成

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

タスクの取得

"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"

タスクの更新

"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"

タスクの完了

"Mark the PR review task as complete"
"Complete the documentation task"

タスクの削除

"Delete the PR review task"
"Remove meeting prep task"

開発

ソースからビルド

# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git

# Navigate to directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

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

問題とサポート

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