Todoist とは
Todoist は、世界中で広く使われているシンプルなタスク管理ツールです。プロジェクト・ラベル・優先度・期限などの基本機能で、個人のやることリストから小規模チームのタスク管理まで対応します。
「今日やること」「期限がもうすぐ」など、よくある日常のタスク管理シーンに最適化された UI が特徴。ブラウザ・スマホ・デスクトップアプリすべてで同期され、書いた瞬間どこからでも確認できる手軽さが支持されています。
これは公式提供ではなく、有志が作った非公式ツールです。
Todoist × AI でできること
このMCPサーバーを導入すると、Todoist のタスクをAIへの一言で操作できます。
📝 追加する
「明日締め切りで『資料レビュー』を高優先度で追加」
→ 期限・優先度付きの新規タスクを作成
📋 一覧化する
「今日の未完了タスクを優先度順で見せて」
→ フィルタ条件付きでタスク一覧を取得
✏️ 更新する
「『資料レビュー』の期限を金曜にずらして」
→ 部分名マッチでタスクを検索して期限を更新
✅ 完了・削除する
「『○○タスク』を完了にして」「不要になった『△△』を削除」
→ タスクを完了状態に変更 / 削除
提供される主なツール
Todoist MCP Server が提供するツール一覧(全5件):
| ツール | 役割 |
|---|---|
todoist_create_task | コンテンツ・説明・期限・優先度(1〜4)を指定してタスクを作成 |
todoist_get_tasks | 期限・優先度・プロジェクト別にタスクをフィルタリング取得 |
todoist_update_task | 部分名マッチでタスクを検索して任意属性を変更 |
todoist_complete_task | 部分名マッチでタスクを検索して完了状態に変更 |
todoist_delete_task | 部分名マッチでタスクを検索して削除 |
シンプルな5ツール構成で、タスクの CRUD 操作に特化しています。プロジェクトやラベル自体の作成・管理は対象外で、既存プロジェクト・ラベルへの紐付けによる利用が前提です。
Todoist MCP Server について
Todoist MCP Server は、abhiz123 氏がコミュニティで開発・公開している MCP サーバーです。Todoist API を経由してタスクの作成・取得・更新・完了・削除を AI エージェントから実行できます。
タスクの CRUD に特化した最もミニマルな MCP の1つで、Todoist アプリを開かずに「今日やること」「明日のタスク追加」「期限変更」をチャットで完結できる構成です。
スペック
- 配布形態: npm パッケージ
@abhiz123/todoist-mcp-server(npx起動) - 認証: Todoist API Token(環境変数
TODOIST_API_TOKEN) - 提供元: コミュニティ製(abhiz123 / MIT ライセンス)
- 対応範囲: タスクの CRUD(プロジェクト・ラベル自体の管理は対象外)
- メンテナンス: 393スター(最終更新 2025-04・archived ではない)
導入手順
前提条件
- Node.js(
npxが利用できる環境) - Todoistアカウント(無料プランで動作)
- Todoist APIトークン
APIトークンの取得方法
- Todoist にログイン
- 右上のアバターをクリック →「設定」を開く
- 「連携(Integrations)」→「デベロッパー(Developer)」タブに表示されている API トークンをコピー
ステップ
- 使用環境のタブを選択し、設定例をコピー
<YOUR_TODOIST_API_TOKEN>を取得したAPIトークンに置き換える- 設定ファイルに追記して保存し、クライアントを再起動
動作確認
「Todoistに接続して、今日のタスクを教えて」と話しかけてみてください。
注意事項
TODOIST_API_TOKENは個人のアカウントに紐づく認証情報です。他者と共有しないでください。- このMCPはタスクの CRUD のみを提供します。プロジェクト・ラベル自体の作成や管理は対象外です(既存プロジェクト・ラベルへのタスク紐付けは可能)。
- タスクの削除操作は元に戻せないため、AIへの指示は具体的に行ってください。
- 無料プランでも基本機能(タスクの読み書き)は利用できます。
設定方法
MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。
Claude Desktop / Claude Code: Claude Desktop(公式デスクトップアプリ)と Claude Code(公式CLI)は同じ JSON を使います。Desktop は設定ファイルに貼り付け、Claude Code は `.mcp.json` に記述するか `claude mcp add` で追加します。
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}
Cursor: AI 機能を内蔵したコードエディタ(`~/.cursor/mcp.json` に記述)
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}
Cline: VS Code に追加する AI アシスタント拡張(設定画面の MCP Servers から記述)
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}
Gemini CLI: Google の AI CLI。設定形式は Claude Desktop と同じで、`~/.gemini/settings.json` の `mcpServers` に記述するか `gemini mcp add` で追加します。
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}
OpenAI Codex: OpenAI の CLI/IDE。設定は TOML 形式で `~/.codex/config.toml` に記述します(下記は左の JSON から自動変換した参考値です)。
[mcp_servers.todoist]
command = "npx"
args = ["-y", "@abhiz123/todoist-mcp-server"]
[mcp_servers.todoist.env]
TODOIST_API_TOKEN = "<YOUR_TODOIST_API_TOKEN>"VS Code: VS Code(GitHub Copilot のエージェント)。`mcp.json` の `servers` キーに記述します(下記は左の JSON から自動変換した参考値です)。
{
"servers": {
"todoist": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhiz123/todoist-mcp-server"
],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}※ Gemini CLI は Claude Desktop と同じ mcpServers 形式のため同一の JSON を表示しています。Codex / VS Code タブの設定は、上記 JSON を各公式スキーマ(Codex=~/.codex/config.toml の TOML 形式 / VS Code=mcp.json の servers キー)へ 自動変換した参考値です。貼り付け前にお使いのバージョンの公式ドキュメントもご確認ください。
主なユースケース
- 「今日の未完了タスクを優先度順にリストアップして、何から始めるか提案して」という毎朝のルーティンをAIに任せる
- ミーティング後に「アクションアイテムをTodoistに追加して、各タスクに期限と優先度をつけて」とAIに整理させる
- 「今週締め切りのタスクと、まだ取り組んでいないものを教えて」という進捗確認をチャットから実行できる
- 「『資料レビュー』タスクの期限を金曜にずらして」のように部分名マッチでタスクを検索・更新できる
プラットフォーム別の注意事項
- WindowsWindowsでも `npx` コマンドで動作します。`TODOIST_API_TOKEN` は環境変数として設定するか、設定ファイルに直接記載してください。
- プロキシ環境Todoist APIへのアクセスにはインターネット接続が必要です。社内プロキシ環境では `HTTPS_PROXY` 環境変数を設定してください。