Chrusic Todoist MCP Server Extended

🚀 Todoist MCP サーバー拡張版

このサーバーは、ClaudeとTodoistを統合したMCP（モデルコンテキストプロトコル）サーバーの実装で、自然言語によるタスク管理をサポートしています。Claudeが日常用語を使って、あなたのTodoistのタスク、プロジェクト、セクション、タグとやり取りできるようになります。

🚀 クイックスタート

このサーバーはClaudeとTodoistを統合し、自然言語でのタスク管理を可能にします。Claudeが日常用語でTodoistのタスクやプロジェクトを操作できます。

✨ 主な機能

• プロジェクト管理：Todoistのプロジェクトを作成、更新、管理します。
• セクション管理：プロジェクト内でセクションを作成、管理します。
• タスク管理：日常言語を使ってタスクを作成、更新、完了、削除します。
• タグ管理：個人用タグとタスクタグを作成、更新、管理します。
• スマート検索：セクション名でタスクとタグを検索します。
• 柔軟なフィルタリング：プロジェクト、セクション、期限、優先度、タグでタスクをフィルタリングします。
• 詳細なタスク情報：説明、期限、優先度、プロジェクトの割り当てをサポートします。

完全なツールリストとその使用方法については、.docs の tools.md を参照してください。

📦 インストール

Smitheryを通じたインストール

Smithery を通じてTodoist拡張サーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

手動インストール

このパッケージはまだnpmに公開されていません。

📚 ドキュメント

Todoist APIトークンの取得

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

Todoist APIの詳細については、公式Todoist APIドキュメント を参照してください。

ClineでMCPを設定する

以下の内容をあなたのCline MCP設定ファイルに追加します。

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["todoist-mcp-enhanced-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

💻 使用例

基本的な使用法

"プロジェクト'仕事'のセクション'やること'にタスク'PRをレビューする'を作成する"
"タスク'PRをレビューする'にタグ'重要'を追加する"
"プロジェクト'仕事'内のタグ'重要'が付いたすべてのタスクを表示する"
"タスク'ドキュメント'をセクション'進行中'に移動する"
"ドキュメントタスクを完了としてマークする"

開発

ソースコードからビルドする

# リポジトリをクローンする
git clone https://github.com/Chrusic/todoist-mcp-server-extended.git

# ディレクトリに移動する
cd todoist-mcp-server-extended

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

🤝 コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

このプロジェクトは LICENSE ファイルに詳述されているMITライセンスの下で公開されています。

❓ 問題とサポート

何か問題があったり、サポートが必要な場合は、GitHubリポジトリ で問題を報告してください。