mcp-todo

todo.txt形式に基づいたTodo管理ツールをMCP（Model Context Protocol）サーバーとして提供します。 データは deno kv を利用してローカルに保持されます。

必要条件

• deno

セットアップ

MCPサーバー設定

Clineなどのクライアントツールで使用するために、MCPサーバー設定を構成します。 以下の設定をMCPサーバ設定に追加してください。

{
  "mcpServers": {
    "mcp-todo": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "--unstable-kv",
        "jsr:@showichiro/mcp-todo"
      ]
    }
  }
}

機能

このMCPサーバーは以下のツールを提供します（開発中で随時追加予定）：

Todoツール

• mcp_todo_create: 新しいTodoアイテムを作成
• mcp_todo_get_by_id: IDによってTodoアイテムを取得
• mcp_todo_get_all: すべてのTodoアイテムを取得
• mcp_todo_get_by_priority: 優先度によってTodoアイテムをフィルタリング
• mcp_todo_get_by_context: コンテキストによってTodoアイテムをフィルタリング
• mcp_todo_get_by_project: プロジェクトによってTodoアイテムをフィルタリング
• mcp_todo_get_by_completion: 完了状態によってTodoアイテムをフィルタリング
• mcp_todo_update: IDを指定してTodoアイテムを更新
• mcp_todo_delete: IDを指定してTodoアイテムを削除

Todo形式

このツールはtodo.txt形式に基づいています。Todoアイテムは以下の要素を含むことができます：

• 完了状態（完了した場合は「x」で始まる）
• 優先度（A-Zの文字、括弧で囲まれる）
• 作成日（YYYY-MM-DD形式）
• 完了日（完了している場合、YYYY-MM-DD形式）
• 説明（Todoの内容）
• プロジェクト（「+」で始まる）
• コンテキスト（「@」で始まる）
• タグ（「key:value」形式）

例：

x (A) 2023-04-01 2023-03-15 レポートを完成させる +仕事 @オフィス 締切:2023-04-01

使用例

新しいTodoの作成

{
  "description": "買い物に行く",
  "priority": "B",
  "projects": ["個人"],
  "contexts": ["外出"],
  "tags": {
    "締切": "2023-04-15"
  }
}

Todoの更新

{
  "id": "todo_id",
  "completed": true,
  "priority": "A",
  "description": "更新後の説明",
  "projects": ["仕事"],
  "contexts": ["オフィス"],
  "tags": {
    "締切": "2024-04-01"
  }
}

Todoの削除

{
  "id": "todo_id"
}

優先度によるTodoの取得

{
  "priority": "A"
}

コンテキストによるTodoの取得

{
  "context": "仕事"
}

プロジェクトによるTodoの取得

{
  "project": "個人"
}

完了状態によるTodoの取得

{
  "completed": false
}

すべてのTodoの取得

{
  "random_string": "dummy"
}