Skip to content

README.md

Latest commit

 

History

History
159 lines (120 loc) · 3.27 KB

README.md

File metadata and controls

159 lines (120 loc) · 3.27 KB

TODO MCP Server

TODOを管理するためのMCPサーバーです

機能

  • TODOの作成・更新・削除
  • TODOの一覧表示・個別取得
  • タグによる分類・絞り込み
  • 完了状態の管理

インストール

go install github.com/kosuke9809/todo-mcp@latest

使用方法

Claude Desktop/Codeでの設定

claude_desktop_config.json に以下を追加：

{
  "mcpServers": {
    "todo-mcp": {
      "command": "todo-mcp"
    }
  }
}

Tools

1. create-todo

新しいTODOを作成します。

パラメータ:

  • title (必須): TODOのタイトル
  • description (オプション): TODOの詳細説明
  • tags (オプション): タグのリスト

例:

create-todo title:"買い物に行く" description:"牛乳とパンを買う" tags:["日常", "買い物"]

2. list-todos

TODOの一覧を表示します。

パラメータ:

  • tag (オプション): 特定のタグで絞り込み
  • showCompleted (オプション): 完了済みTODOも表示するか (default: false)
  • limit (オプション): 取得件数の上限

例:

list-todos
list-todos tag:"買い物" showCompleted:true limit:5

3. get-todo

特定のTODOの詳細を取得します。

パラメータ (どちらか一つが必須):

  • id: TODOのID
  • index: TODOのインデックス番号（1から開始）

例:

get-todo index:1
get-todo id:"abc123..."

4. update-todo

既存のTODOを更新します。

パラメータ:

  • id または index (どちらか必須): 更新するTODOの指定
  • title (オプション): 新しいタイトル
  • description (オプション): 新しい詳細説明
  • tags (オプション): 新しいタグのリスト

例:

update-todo index:1 title:"新しいタイトル"
update-todo id:"abc123..." description:"更新された説明"

5. delete-todo

TODOを削除します。

パラメータ (どちらか一つが必須):

  • id: TODOのID
  • index: TODOのインデックス番号（1から開始）

例:

delete-todo index:3
delete-todo id:"abc123..."

6. complete-todo

TODOの完了状態を変更します。

パラメータ:

  • id または index (どちらか必須): 対象TODOの指定
  • completed (必須): 完了状態 (true: 完了、false: 未完了)

例:

complete-todo index:1 completed:true
complete-todo index:2 completed:false

データストレージ

TODOデータは ~/.todo-mcp/todos.json に保存されます。

使用例

基本的なワークフロー

  1. TODOを作成

    create-todo title:"レポート作成" tags:["仕事", "重要"]

  2. 一覧を確認

    list-todos

    出力例:

    📝 TODO一覧 (1件):
1. ⭕ レポート作成 [仕事 重要]
   🆔 ID: abc12345-...

  3. インデックス番号で操作

    update-todo index:1 description:"明日までに完成させる"
complete-todo index:1 completed:true

  4. 完了済みも含めて確認

    list-todos showCompleted:true

タグを使った管理

create-todo title:"食材購入" tags:["買い物", "日常"]
create-todo title:"プレゼント選び" tags:["買い物", "特別"]
list-todos tag:"買い物"