Todoist

🚀 Todoist MCP サーバー

Todoist と統合された Model Context Protocol (MCP) サーバーの実装です。Claude やその他の AI アシスタントが自然言語でタスク管理を行えるようになります。

🚀 クイックスタート

この MCP サーバーを使用するには、Todoist API トークンが必要です。

Todoist API トークンの取得

1. Todoist アカウントにログインします。
2. 設定 → 統合に移動します。
3. 「開発者」セクションで API トークンを見つけます。

Claude Desktop との使用方法

claude_desktop_config.json に以下を追加します。

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

✨ 主な機能

• Todoist API の完全統合：Todoist REST API v2 と自然言語による Todoist 同期 API をサポートします。
• バッチ処理：クライアントは一度に複数のタスクを処理する要求を送信できます。
• 名前による検索：AI は ID を必要とせず、名前でタスク、プロジェクト、タグを検索できます。
• タスク管理：自然言語でタスクの作成、更新、完了、再開、移動、削除ができます。
• プロジェクト管理：プロジェクトと部分の作成と管理が可能です。
• コメント機能：タスクとプロジェクトにコメントを追加し、管理できます。
• タグ管理：個人用と共有タグの作成と管理ができます。
• ヒントサポート：クライアントにプロジェクト情報を簡単に提供できます。

📦 インストール

インストールコマンド

# プロジェクトのインストール
npm install

# プロジェクトのビルドとインスペクターの実行
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

💻 使用例

基本的な使用法

# プロジェクトのインストール
npm install

# プロジェクトのビルドとインスペクターの実行
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

📚 ドキュメント

利用可能なツール

タスク管理

• get_tasks_list：タスクリストを取得し、必要に応じてプロジェクト、部分、タグなどでフィルタリングできます。
• create_tasks：様々な属性を持つ新しいタスクを作成します。
• get_tasks：ID または名前で特定のタスクを取得します。
• update_tasks：既存のタスクを更新します。
• close_tasks：タスクを完了します。
• reopen_tasks：タスクを再開します。
• move_task：タスクを移動します。

プロジェクト管理

• create_project：新しいプロジェクトを作成します。
• get_projects：すべてのプロジェクトを取得します。
• get_project：ID で特定のプロジェクトを取得します。
• update_project：既存のプロジェクトを更新します。
• delete_project：プロジェクトを削除します。

タグ管理

• create_label：新しいタグを作成します。
• get_labels：すべてのタグを取得します。
• get_label：ID で特定のタグを取得します。
• update_label：既存のタグを更新します。
• delete_label：タグを削除します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

問題とサポート

何か問題が発生した場合やサポートが必要な場合は、GitHub リポジトリに問題を提出してください。