Skip to main content
Glama
Sign In
enesjakozh

MCP Todoist

by dkeesey
GitHub
Python
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Todoist

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

特徴

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

前提条件

クイックスタート

1. インストール

# Install using UV uvx mcp-todoist

2. 構成

  1. Todoist 統合設定から Todoist API トークンを取得します
  2. 環境変数を設定します。
    # Add to your .env file or environment TODOIST_API_TOKEN=your_api_token_here
  3. 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 がサーバーを自動的に起動するために使用できる起動スクリプトを作成します。

  1. 次の内容を含む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
  1. スクリプトを実行可能にします。
chmod +x start-todoist-mcp.sh
  1. このスクリプトを使用するには、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

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

  1. 特徴
    1. 前提条件
      1. クイックスタート
        1. インストール
        2. 構成
        3. クロードとの使用
      2. 利用可能なツール
        1. タスク管理
        2. プロジェクト管理
        3. ラベル管理
        4. ユーティリティ
      3. MCPサーバーの実行
        1. 方法1: 直接コマンドライン
        2. 方法2: 起動スクリプトを使用する（推奨）
      4. デバッグ
        1. ログを確認する
        2. デバッグモードを有効にする
        3. APIトークンを確認する
        4. MCPインスペクターを使用する
        5. よくある問題と解決策
      5. 発達
        1. 設定
        2. テスト
        3. 地域開発
      6. ライセンス

        Related MCP Servers

        • Notion MCP

          Badhansen
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
          Last updated -
          13
          Python
          MIT License

        • ConnectWise Manage MCP Server

          ethangillani
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
          Last updated -
          JavaScript
          MIT License
          • Apple

        • Todoist Python MCP Server

          Johnxjp
          -
          security
          A
          license
          -
          quality
          A Model Context Profile server that enables Claude to interact with Todoist, allowing users to create, retrieve, update, and manage tasks through natural language commands.
          Last updated -
          1
          Python
          MIT License

        • Google Tasks MCP Server

          arpitbatra123
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that bridges Claude with Google Tasks, allowing users to manage task lists and tasks directly through Claude interface.
          Last updated -
          5
          TypeScript
          MIT License
          • Apple

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/dkeesey/todoist-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server