Integrations

Enables managing Todoist tasks, projects, and labels. Provides tools for creating, updating, completing, and deleting tasks; organizing tasks in projects and with labels; and searching and filtering tasks based on various criteria.

MCP Todoist

Claude が Todoist アカウントとやり取りできるようにする Model Context Protocol (MCP) サーバー。

特徴

タスクの管理: タスクの作成、更新、完了、削除
プロジェクトとラベルでタスクを整理する
さまざまな基準に基づいてタスクを検索およびフィルタリングします
Claude Desktopとのシームレスな統合

前提条件

Python 3.11以上
アストラルUV
TodoistアカウントとAPIトークン
Claude Desktop（MCPサーバー使用時）

クイックスタート

1. インストール

# Install using UV
uvx mcp-todoist

2. 構成

Todoist 統合設定から Todoist API トークンを取得します
環境変数を設定します。
# Add to your .env file or environment TODOIST_API_TOKEN=your_api_token_here
Claude デスクトップを設定します。
// ~/.config/claude/claude_desktop_config.json or equivalent { "mcpServers": { "mcp-todoist": { "command": "uvx", "args": ["mcp-todoist"] } } }

3. クロードとの使用

設定が完了したら、Claude に Todoist アカウントを操作するよう依頼できます。

「今日が期限のタスクを表示」
「明日食料品を買うための新しいタスクを作成」
「「メールを送信」タスクを完了としてマークする」
「『住宅改修』という新しいプロジェクトを作成する」
「私の仕事プロジェクト内のすべてのタスクを表示」

利用可能なツール

タスク管理

list-tasks - タスクの取得とフィルタリング
create-task - 新しいタスクを作成する
update-task - 既存のタスクを更新する
complete-task - タスクを完了としてマークする
delete-task - タスクを削除する

プロジェクト管理

list-projects - すべてのプロジェクトを取得する
create-project - 新しいプロジェクトを作成する
update-project - プロジェクトを更新する
delete-project - プロジェクトを削除する

ラベル管理

list-labels - すべてのラベルを取得する
create-label - 新しいラベルを作成する
update-label - ラベルを更新する
delete-label - ラベルを削除する

ユーティリティ

search - 複雑なフィルタリングでタスク全体を検索する

MCPサーバーの実行

Todoist MCP サーバーを実行する方法は複数あります。

方法1: 直接コマンドライン

ターミナルウィンドウでサーバーを実行します。

# Set your API token
export TODOIST_API_TOKEN=your_api_token_here

# Run the server using UV
uvx mcp-todoist

# Alternative: Run from source
cd /path/to/mcp-todoist
uv run python -m mcp_todoist

Claude Desktop を使用する間は、このターミナルウィンドウを開いたままにしておきます。

方法2: 起動スクリプトを使用する（推奨）

Claude Desktop がサーバーを自動的に起動するために使用できる起動スクリプトを作成します。

次の内容を含むstart-todoist-mcp.shという名前のファイルを作成します。

#!/bin/bash

# Set environment variables
export MCP_SERVER_NAME="mcp-todoist"
export MCP_LOG_LEVEL="INFO"
export MCP_DEBUG="true"
export TODOIST_API_TOKEN="your_todoist_api_token_here"

# Path to your Todoist MCP server
MCP_PATH="/path/to/mcp-todoist"

# Log file for debugging
LOG_FILE="${MCP_PATH}/todoist-mcp.log"

# Create log file or clear existing one
echo "Starting Todoist MCP server at $(date)" > "${LOG_FILE}"

# Navigate to the project directory
cd "${MCP_PATH}"

# Start the MCP server
echo "Starting MCP server from ${MCP_PATH}" >> "${LOG_FILE}"
uv run python -m mcp_todoist >> "${LOG_FILE}" 2>&1

スクリプトを実行可能にします。

chmod +x start-todoist-mcp.sh

このスクリプトを使用するには、Claude Desktop の構成を更新します。

{
  "mcpServers": {
    "mcp-todoist": {
      "command": "/absolute/path/to/start-todoist-mcp.sh",
      "args": []
    }
  }
}

このアプローチにはいくつかの利点があります。

サーバーはClaude Desktopで自動的に起動します
すべてのログはファイルに記録され、デバッグが容易になります。
環境変数は一貫して設定されている

デバッグ

MCP サーバーで問題が発生した場合、次のデバッグ戦略を実行できます。

1. ログを確認する

起動スクリプトを使用する場合は、ログファイルを確認します。

cat /path/to/mcp-todoist/todoist-mcp.log

2. デバッグモードを有効にする

より詳細なログ記録を行うには、 MCP_DEBUG環境変数をtrueに設定します。

export MCP_DEBUG=true
uvx mcp-todoist

3. APIトークンを確認する

Todoist API トークンが正しく、まだ有効であることを確認します。

# Test the token with a simple curl request
curl -X GET \
  https://api.todoist.com/rest/v2/projects \
  -H "Authorization: Bearer $TODOIST_API_TOKEN"

4. MCPインスペクターを使用する

MCP インスペクターは、MCP サーバーをデバッグするための強力なツールです。

npx @modelcontextprotocol/inspector uvx mcp-todoist

これにより、Claude と MCP サーバー間のすべての通信を表示する Web インターフェイスが開きます。

5. よくある問題と解決策

「MCP サーバーが利用できません」エラー: サーバーが別のターミナルまたは起動スクリプトで実行されていることを確認してください。
認証エラー: Todoist API トークンが環境で正しく設定されていることを確認してください。
「コマンドが見つかりません」エラー: Astral UV がインストールされ、PATH 内にあることを確認してください。
タイムアウトエラー: MCP サーバーの応答が遅い場合は、Claude Desktop 設定でタイムアウトを増やしてみてください。

発達

設定

# Clone the repository
git clone https://github.com/yourusername/mcp-todoist.git
cd mcp-todoist

# Install dependencies
uv sync

テスト

# Run tests
uv run pytest

地域開発

ローカル開発の場合は、Todoist API トークンを使用して.envファイルを作成できます。

TODOIST_API_TOKEN=your_api_token_here

次にサーバーを実行します。

uv run python -m mcp_todoist

ライセンス

MIT ライセンス - 詳細については LICENSE ファイルを参照してください。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude が Todoist アカウントと対話し、自然言語でタスク、プロジェクト、ラベルを管理できるようにするモデルコンテキストプロトコルサーバー。

Appeared in Searches

A tool or application for creating a to-do list