list-todo

/list-todo

Triggers

Use this command when the user says any of: "list-todo", "list todo", "list todos", "show todo", "show todos", "show my todos", "show my tasks", "show my list", "my todos", "my tasks", "todo list", "task list", "what's on my plate", "what do I have on", "what's pending", "open tasks", "outstanding tasks", "what have I got", "what's left", "give me my todos", "todo summary", "task summary", "how many todos", "todo stats", "show [tag] todos", "show [tag] tasks", "overdue todos", "completed todos", "done todos", "high priority todos"

Argument to filter mapping

Argument	Filter params
none / "all"	{"done": false}
a tag name	{"tag": "TAG", "done": false}
"high" / "med" / "low"	{"priority": "LEVEL", "done": false}
"overdue"	{"overdue": true}
"done" / "completed"	{"done": true}
anything else	{"search": "WORD", "done": false}

What to do

Read URL:

URL=$(cat ~/.config/todo-mcp/url 2>/dev/null || echo "")
[ -z "$URL" ] && echo "Run /setup-todo first" && exit 1

Fetch filtered list (MCP direct if available, else curl):

curl -s -N -X POST "$URL/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"todo_list","arguments":{"params":FILTER}}}' \
  | grep '^data:' | python3 -c "
import sys,json
d=json.loads(sys.stdin.read()[5:])
for c in d.get('result',{}).get('content',[]):
    if c.get('type')=='text': print(c['text'])"

Also fetch stats for the header:

curl -s -N -X POST "$URL/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"todo_stats","arguments":{}}}' \
  | grep '^data:' | python3 -c "
import sys,json
d=json.loads(sys.stdin.read()[5:])
for c in d.get('result',{}).get('content',[]):
    if c.get('type')=='text': print(c['text'])"