AT

abhiz123/todoist-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

392 stars 70 forks 品質 68 トレンド 19MIT

Todoist統合のためのMCPサーバーで、Claudeによる自然言語タスク管理を可能にします

概要

ClaudeとTodoistを統合し、自然言語タスク管理を可能にするMCP(Model Context Protocol)サーバー実装です。このサーバーにより、Claudeは日常言語を使ってTodoistのタスクとやり取りできます。 * : 日常用語でタスクを作成、更新、完了、削除 * : 部分的な名前一致でタスクを探す * : タスクを期限、優先度、その他の属性でフィルタリング * : 説明、期限、優先度レベルのサポート * : ユーザー体験を向上させるための明確なフィードバック Smithery経由でTodoist MCP ServerをClaude Desktop用に自動インストールするには: さまざまな属性を持つ新しいタスクを作成する: * 必須:コンテンツ(タスクタイトル) * オプション: 説明、期限、優先度レベル(1-4) * 例:「『明日提出期限』の説明で『チームミーティング』を作成する」 タスクの取得とフィルタリング:* 締め切り、優先度、プロジェクトでフィルタリング * 自然言語の日付フィルタリング * オプションの結果制限 * 例:「今週締め切りの優先度の高いタスクを表示する」 既存のアップデート...

概要(AI 翻訳)

ClaudeとTodoistを統合し、自然言語タスク管理を可能にするMCP(Model Context Protocol)サーバー実装です。このサーバーにより、Claudeは日常言語を使ってTodoistのタスクとやり取りできます。

特徴

  • 自然言語タスク管理:日常言語を使ってタスクを作成、更新、完了、削除
  • スマートタスク検索:部分的な名前一致を使ってタスクを検索
  • 柔軟なフィルタリング:タスクを期限、優先度、その他の属性でフィルタリング
  • リッチタスク詳細:記述、期限、優先度レベルのサポート 直感的なエラー処理:ユーザー体験向上のための明確なフィードバック

設置

Smithery経由のインストール

Smithery経由でTodoist MCP ServerをClaude Desktop用に自動インストールするには:

手動インストール

道具

todoist_create_task

さまざまな属性を持つ新しいタスクを作成する:

  • 必須:コンテンツ(タスクタイトル)
  • 任意:説明、期限、優先度レベル(1-4)
  • 例:「『チームミーティング』の説明で『明日締め切り』のタスクを作成」

todoist_get_tasks

タスクの取得とフィルタリング:

  • 締め切り、優先順位、プロジェクトでフィルタリング
  • 自然言語の日付フィルタリング

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Todoist MCP Server

An MCP (Model Context Protocol) server implementation that integrates Claude with Todoist, enabling natural language task management. This server allows Claude to interact with your Todoist tasks using everyday language.

Features

  • Natural Language Task Management: Create, update, complete, and delete tasks using everyday language
  • Smart Task Search: Find tasks using partial name matches
  • Flexible Filtering: Filter tasks by due date, priority, and other attributes
  • Rich Task Details: Support for descriptions, due dates, and priority levels
  • Intuitive Error Handling: Clear feedback for better user experience

Installation

Installing via Smithery

To install Todoist MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install -g @abhiz123/todoist-mcp-server

Tools

todoist_create_task

Create new tasks with various attributes:

  • Required: content (task title)
  • Optional: description, due date, priority level (1-4)
  • Example: “Create task ‘Team Meeting’ with description ‘Weekly sync’ due tomorrow”

todoist_get_tasks

Retrieve and filter tasks:

  • Filter by due date, priority, or project
  • Natural language date filtering
  • Optional result limit
  • Example: “Show high priority tasks due this week”

todoist_update_task

Update existing tasks using natural language search:

  • Find tasks by partial name match
  • Update any task attribute (content, description, due date, priority)
  • Example: “Update meeting task to be due next Monday”

todoist_complete_task

Mark tasks as complete using natural language search:

  • Find tasks by partial name match
  • Confirm completion status
  • Example: “Mark the documentation task as complete”

todoist_delete_task

Remove tasks using natural language search:

  • Find and delete tasks by name
  • Confirmation messages
  • Example: “Delete the PR review task”

Setup

Getting a Todoist API Token

  1. Log in to your Todoist account
  2. Navigate to Settings → Integrations
  3. Find your API token under “Developer”

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Example Usage

Creating Tasks

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
GitHub で README 全文を見る

インストール

npx -y @abhiz123/todoist-mcp-server
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "todoist": { "command": "npx", "args": ["-y", "@abhiz123/todoist-mcp-server"], "env": { "TODOIST_API_TOKEN": "your_api_token_here" } } } }