trackmcp
Back to directory
DialBird

todoist-mcp

View on GitHub

Todoist MCP

0 stars TypeScriptOthers Updated Jul 2, 2025

Documentation

Todoist MCP

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

機能

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

前提条件

1. Deno: バージョン1.37以上がインストールされていること

2. Todoist CLI: sachaos/todoistがインストール・設定済みであること

Todoist CLIのインストール

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

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

Todoist CLIの設定

bash
# Todoistにログイン
todoist sync

使用方法

開発モードで起動

bash
deno task dev

本番モードで起動

bash
deno task start

テスト実行

bash
deno task test

利用可能なツール

1. todoist_list_tasks

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

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

2. todoist_add_task

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

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

3. todoist_complete_task

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

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

4. todoist_list_projects

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

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

MCPクライアントでの使用

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

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

ライセンス

MIT

Frequently asked questions

What is todoist-mcp?

todoist-mcp is Todoist MCP

How do I install todoist-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is todoist-mcp open source?

Yes — it is hosted on GitHub at https://github.com/DialBird/todoist-mcp.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP