Todo.txt MCP Server

Todo.txt MCP サーバー

todo.txt ファイルを Claude などの AI アシスタントに接続する Model Context Protocol サーバーです。プレーンテキストのシンプルさと移植性を保ちながら、自然言語でタスクを管理できます。

インストール

# Recommended
uv tool install todo-txt-mcp

# Or run directly without installing
uvx todo-txt-mcp

# Alternatives
pipx install todo-txt-mcp
pip install todo-txt-mcp

設定

Claude Desktop の設定に追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "todo-txt": {
            "command": "uvx",
            "args": [
                "todo-txt-mcp"
            ]
        }
    }
}

Claude Desktop を再起動します。ツールアイコンでサーバーが接続されていることを確認できます。

todo.txt の場所をカスタマイズする

{
    "mcpServers": {
        "todo-txt": {
            "command": "uvx",
            "args": [
                "todo-txt-mcp",
                "/path/to/your/todo.txt"
            ]
        }
    }
}

todo.sh との連携

todo.sh を使用している場合、サーバーは ~/.todo/config、~/.todo.cfg、または標準のシステム上の場所から設定を自動的に検出します。

環境変数

TODO_MCP_TODO_FILE_PATH=/path/to/todo.txt
TODO_MCP_BACKUP_ENABLED=true
TODO_MCP_MAX_FILE_SIZE=10000000

利用可能なツール

ツール	説明
list_todos	任意のフィルターを指定してタスクを一覧表示します
add_todo	新しいタスクを作成します
complete_todo	タスクを完了済みにします
update_todo	既存のタスクを変更します
delete_todo	タスクを削除します
search_todos	テキストでタスクを検索します
filter_by_priority	優先度（A～Z）で絞り込みます
filter_by_project	プロジェクト（+タグ）で絞り込みます
filter_by_context	コンテキスト（@タグ）で絞り込みます
get_statistics	タスクの統計情報を取得します

Todo.txt の形式

todo.txt の仕様に完全準拠しています。

(A) Call Mom +family @phone
x 2025-05-31 2025-05-30 (B) Buy groceries +shopping @errands
Write project proposal +work @computer

コントリビューション

ガイドラインについては CONTRIBUTING.md をご覧ください。バグの報告や機能のリクエストは、GitHub Issues からお寄せください。

ライセンス

MIT — LICENSE をご覧ください。