Todoist MCP サーバー
ClaudeとTodoistを統合し、自然言語によるタスク管理を可能にするMCP（モデル・コンテキスト・プロトコル）サーバー実装。このサーバーにより、Claudeは日常的な言語でTodoistタスクを操作できるようになります。
特徴
- 自然言語タスク管理: 日常言語を使用してタスクを作成、更新、完了、削除します
- スマートタスク検索: 部分的な名前一致を使用してタスクを検索
- 柔軟なフィルタリング: 期日、優先度、その他の属性でタスクをフィルタリングします
- 豊富なタスク詳細:説明、期限、優先度レベルのサポート
- 直感的なエラー処理: 明確なフィードバックでユーザーエクスペリエンスを向上
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の Todoist MCP Server を自動的にインストールするには:
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
手動インストール
npm install -g @abhiz123/todoist-mcp-server
ツール
todoist_タスク作成
さまざまな属性を持つ新しいタスクを作成します。
- 必須: コンテンツ（タスクタイトル）
- オプション: 説明、期日、優先度 (1-4)
- 例: 「明日までに「週次同期」という説明で「チームミーティング」というタスクを作成する」
todoist_get_tasks
タスクを取得してフィルタリングする:
- 期日、優先度、プロジェクトでフィルタリング
- 自然言語による日付フィルタリング
- オプションの結果制限
- 例:「今週期限の高優先度タスクを表示する」
todoist_更新_タスク
自然言語検索を使用して既存のタスクを更新します。
- 名前の部分一致でタスクを検索する
- タスクの属性（内容、説明、期日、優先度）を更新する
- 例: 「来週の月曜日までに会議タスクを更新する」
todoist_完了_タスク
自然言語検索を使用してタスクを完了としてマークします。
- 名前の部分一致でタスクを検索する
- 完了ステータスを確認する
- 例:「ドキュメントタスクを完了としてマークする」
todoist_タスクの削除
自然言語検索を使用してタスクを削除します。
- 名前でタスクを検索して削除する
- 確認メッセージ
- 例:「PRレビュータスクを削除する」
設定
Todoist APIトークンを取得する
- Todoistアカウントにログイン
- 設定→統合へ移動
- 「開発者」の下でAPIトークンを見つけます
Claude Desktopでの使用
claude_desktop_config.jsonに追加します:
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
}
}
}
}
使用例
タスクの作成
"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"
タスクの取得
"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"
タスクの更新
"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"
タスクの完了
"Mark the PR review task as complete"
"Complete the documentation task"
タスクの削除
"Delete the PR review task"
"Remove meeting prep task"
発達
ソースからのビルド
# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git
# Navigate to directory
cd todoist-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
問題とサポート
問題が発生した場合やサポートが必要な場合は、 GitHub リポジトリに問題を報告してください。