Skip to main content
Glama

Todoist Python MCP Server

by Johnxjp

Todoist MCP サーバー

ClaudeのようなクライアントがTodoistと対話し、自然言語によるタスク管理機能を実現するModel Context Protocol(MCP)サーバー。このサーバーはクライアントとTodoist APIの仲介役として機能し、認証、データ変換、コマンド処理を行います。これはPythonバージョンです。

特徴

  • タスク作成: 必要なコンテンツとオプションの属性を持つ新しいタスクを作成します
  • タスクの取得: IDでタスクを取得、またはフィルタリングオプションを使用してタスクを一覧表示します
  • タスク管理: タスク属性の更新、タスクを完了としてマーク、タスクの削除

前提条件

  • Python 3.12
  • 紫外線
  • TodoistアカウントとAPIトークン

Todoist APIトークンの取得方法

  1. Todoistアカウントにログイン
  2. ユーザー設定 -> 統合 -> 開発者に移動します
  3. APIトークンをコピー

Claude Desktopでの使用

UVX経由で実行(クローンなし)

UVX を使用して GitHub から直接サーバーを実行できます。

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

次に、この構成を Claude 設定に追加します。

{ "mcpServers": { "todoist-server": { "command": "uvx", "args": [ "--from", "https://github.com/Johnxjp/todoist-mcp-python.git", "mcp-server-todoist" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

クローンしたリポジトリから実行

リポジトリのクローンを作成する場合は、次のコマンドを使用します。

git clone git@github.com:Johnxjp/todoist-mcp-python.git

次に、Claude 構成ファイルに以下を追加します。

{ "mcpServers": { "todoist-server": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "todoist_api_python", "mcp", "run", "/full/path/to/todoist_server.py" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

利用可能なツール

サーバーは、Claude が使用できる次のツールを提供します。

  1. create_task : Todoistで新しいタスクを作成する
    • 必須: コンテンツ(タスクのタイトル)
    • オプション:
      • 説明、
      • 期日、
      • 優先度、
      • プロジェクトID、
      • セクションID、
      • ラベル
  2. get_tasks : さまざまなフィルターを使用して Todoist からタスクと ID のリストを取得します。
    • オプション:
      • プロジェクトID、
      • プロジェクト名、
      • タスク名、
      • 優先度、
      • ラベル、
      • 期限超過、
      • 制限
  3. update_task : 既存のタスクを名前で検索して更新する
    • 必須: タスクID
    • オプション:
      • コンテンツ、
      • 説明、
      • ラベル、
      • 優先度、
      • 期日(YYYY-MM-DD)
      • 締め切り日(YYYY-MM-DD)
  4. delete_task : 名前で検索してタスクを削除する
    • 必須: タスクID
  5. complete_task : タスクを名前で検索して完了としてマークします
    • 必須: タスクID

やり取りの例

Claude がこの MCP サーバーを介して Todoist とやり取りする方法の例をいくつか示します。

  • 「食料品を買うタスクを追加」
  • 「緊急のタスクをすべて表示」
  • 「今日期限が迫っているタスクは何ですか?」
  • 「洗濯タスクを完了としてマークする」
  • 「歯医者の予約の優先度を緊急に変更する」

セキュリティに関する考慮事項

  • サーバーは環境変数を通じてTodoist APIトークンを安全に処理します
  • .envファイルを共有したり、APIトークンを公開したりしないでください。
  • サーバーはローカルで実行され、Todoist APIとのみ通信します。

ライセンス

MITライセンス

謝辞

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Claude が Todoist と対話し、ユーザーが自然言語コマンドを使用してタスクを作成、取得、更新、管理できるようにするモデル コンテキスト プロファイル サーバー。

  1. 特徴
    1. 前提条件
      1. Todoist APIトークンの取得方法
    2. Claude Desktopでの使用
      1. UVX経由で実行(クローンなし)
        1. クローンしたリポジトリから実行
          1. 利用可能なツール
            1. やり取りの例
              1. セキュリティに関する考慮事項
                1. ライセンス
                  1. 謝辞

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      An MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.
                      Last updated -
                      5
                      245
                      153
                      JavaScript
                      MIT License
                    • -
                      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
                    • A
                      security
                      A
                      license
                      A
                      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 -
                      15
                      9
                      TypeScript
                      MIT License
                      • Apple
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol service for Claude that enables natural language interaction with Microsoft Todo tasks, including viewing task lists, creating tasks, and managing checklist items.
                      Last updated -
                      13
                      111
                      3
                      TypeScript
                      • Apple
                      • Linux

                    View all related 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/Johnxjp/todoist-mcp-python'

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