Todoist MCP

Manage Todoist tasks and projects using the Todoist CLI.

Todoist MCP

DenoでTodoistのCLIを呼び出すMCPサーバーです。

機能

  • タスク一覧取得: Todoistのタスク一覧を取得
  • タスク追加: 新しいタスクをTodoistに追加
  • タスク完了: 指定したタスクを完了状態にする
  • プロジェクト一覧: Todoistプロジェクトの一覧を取得

前提条件

  1. Deno: バージョン1.37以上がインストールされていること
  2. Todoist CLI: sachaos/todoistがインストール・設定済みであること

Todoist CLIのインストール

# Homebrewを使用する場合
brew install sachaos/todoist/todoist

# または直接ダウンロード
# GitHubリリースページから適切なバイナリをダウンロード

Todoist CLIの設定

# Todoistにログイン
todoist sync

使用方法

開発モードで起動

deno task dev

本番モードで起動

deno task start

テスト実行

deno task test

利用可能なツール

1. todoist_list_tasks

タスク一覧を取得します。

{
  "name": "todoist_list_tasks",
  "arguments": {
    "filter": "today"  // オプション: フィルター条件
  }
}

2. todoist_add_task

新しいタスクを追加します。

{
  "name": "todoist_add_task",
  "arguments": {
    "content": "新しいタスク",      // 必須: タスクの内容
    "project": "プロジェクト名",   // オプション: プロジェクト
    "due": "today",               // オプション: 期限日
    "priority": 3                 // オプション: 優先度(1-4)
  }
}

3. todoist_complete_task

タスクを完了状態にします。

{
  "name": "todoist_complete_task",
  "arguments": {
    "taskId": "123456789"  // 必須: タスクID
  }
}

4. todoist_list_projects

プロジェクト一覧を取得します。

{
  "name": "todoist_list_projects",
  "arguments": {}
}

MCPクライアントでの使用

Claude DesktopなどのMCPクライアントで使用する場合、設定ファイルに以下を追加:

{
  "mcpServers": {
    "todoist": {
      "command": "deno",
      "args": ["run", "--allow-run", "--allow-env", "/path/to/todoist-mcp/main.ts"]
    }
  }
}

ライセンス

MIT

Related Servers