command

MCP.Pizza Chef: scopecraft

Some people keep their to-do list as plain Markdown files in a project rather than in a task app. This makes that pile workable: an assistant can create tasks, update them, move them between phases, and show what is outstanding, while the files stay plain text you can read and commit. It works from the command line too, so the same list is usable with or without an assistant. Setup is a small config entry.

Coding
Notes
Writing

Use This MCP server To

See which tasks are still outstanding Add a task without opening an editor Move a task to the next phase Find tasks related to one piece of work Get a summary of what changed this week Reorganise my task files without hand-editing

README

Scopecraft Command

A comprehensive toolset for managing Markdown-Driven Task Management (MDTM) files. This project provides both a Command Line Interface (CLI) and a Model Context Protocol (MCP) server for working with tasks directly.

Key Features:

  • Works both with and without Roo Commander
  • Supports the standardized MDTM format (with TOML/YAML frontmatter)
  • Automatically detects project type and adapts accordingly
  • Provides direct CRUD operations on task files without requiring LLM processing

Architecture

The project is organized into three main components:

  1. Core - Core task management functionality shared by both CLI and MCP server
    • Features a modular architecture with task operations split into focused modules
    • Each module has a single responsibility (e.g., task-crud.ts, phase-crud.ts, task-relationships.ts)
  2. CLI - Command-line interface for interacting with tasks
  3. MCP - MCP-compatible server for integration with Roo Commander LLMs

The system supports the MDTM directory structure, allowing you to organize tasks in feature-specific subdirectories:

Installation

Option 1: Install from NPM

Global Installation
# Install globally with npm
npm install -g @scopecraft/cmd

# Or with yarn
yarn global add @scopecraft/cmd

# Or with bun
bun install -g @scopecraft/cmd

After global installation, the following commands will be available anywhere on your system:

  • scopecraft / sc - CLI for task management
  • scopecraft-mcp / sc-mcp - MCP server (HTTP/SSE with SDK implementation)
  • scopecraft-stdio / sc-stdio - MCP server with STDIO transport
Using with npx (No Installation Required)

You can run the commands directly without installation using npx:

command FAQ

Can I use this to manage tasks kept as plain files?
Yes — it reads and writes Markdown task files directly, so your list stays plain text.
Do my tasks stay readable without the tool?
Yes, they remain ordinary Markdown files you can open, edit, and commit like any other file.
Do I need an account or key?
No account is needed; it works against files already on your machine.
Can I use it without an assistant?
Yes — there is a command-line interface, so the same task list works either way.
How hard is it to set up?
You paste a small config entry into your assistant's settings, so no coding is required.