About Claude Do
Claude Do is an MCP server in the Productivity category: tUI todo app with MCP server for Claude Code. It has been installed 0 times through Conduid.
Install
git clone https://github.com/orangemelono/Claude-DoThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Claude Do
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
claude-do
A terminal todo list with a live-reloading TUI and an MCP server so Claude can read and manage your tasks.
┌─ Todo Lists ──────────────────────────┐
│ work personal shopping │
└───────────────────────────────────────┘
┌─ todos/work.txt ──────────────────────┐
│ [x] Write project proposal │
│ [ ] Review pull requests │ ← active task (cyan)
│ [ ] Update documentation │
└───────────────────────────────────────┘
←→ switch ↑↓ navigate Enter toggle d delete q quit
Install
curl -fsSL https://raw.githubusercontent.com/orangemelono/claude-do/master/install.sh | bash
Installs claude-do and mcp_server to ~/.local/bin. Override with CLAUDE_DO_INSTALL_DIR=/your/path.
Linux only for pre-built binaries. macOS: build from source.
Or build from source (requires Rust):
cargo build --release
# binaries in target/release/
Usage
TUI
./claude-do # looks for ./todos/*.txt
./claude-do ~/tasks # custom directory
Todo lists are plain .txt files with [ ] / [x] checkboxes:
+------------------------------------------+
| WORK |
+------------------------------------------+
| [ ] Write project proposal |
| [x] Set up CI pipeline |
+------------------------------------------+
Keys:
| Key | Action |
|---|---|
← / → |
Switch between lists |
↑ / ↓ |
Move cursor between tasks |
Enter |
Toggle task done/undone |
d |
Delete the current list |
q / Esc |
Quit |
The TUI hot-reloads when files change on disk — edits from Claude or another tool show up instantly. New .txt files added to the directory appear as tabs automatically; deleted files disappear without needing a restart.
MCP Server (Claude Code integration)
Add to your project's .mcp.json:
{
"mcpServers": {
"claude-do": {
"command": "/path/to/mcp_server",
"args": []
}
}
}
Run mcp_server from the directory that contains your todos/ folder. Claude then has access to five tools:
| Tool | Description |
|---|---|
create_todo_list |
Create a new list with optional initial tasks |
get_todo_list |
Read a list's contents |
toggle_todo |
Mark a task done or undone by line number |
highlight_task |
Set the active/focused task (shown in cyan in the TUI) |
delete_todo_list |
Permanently delete a list — Claude will confirm with you first unless you explicitly asked it to delete |
Todo file format
Files live in a todos/ directory and are plain text. The tab name in the TUI comes from the filename (without .txt). You can create them by hand or via create_todo_list.
README mirrored from the source repository 5 months ago. The original is authoritative.