About Claude Do
Claude Do is an MCP server in the Productivity category: tUI todo app with MCP server for Claude Code.
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.
Tools (5)
create_todo_listCreate a new list with optional initial tasks
Parameters not published.
delete_todo_listPermanently delete a list — Claude will confirm with you first unless you explicitly asked it to delete
Parameters not published.
get_todo_listRead a list's contents
Parameters not published.
highlight_taskSet the active/focused task (shown in cyan in the TUI)
Parameters not published.
toggle_todoMark a task done or undone by line number
Parameters not published.
Ask AI
Ask AI about Claude Do
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run 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 copy captured when this server was indexed; it may lag the repository. The original is authoritative.