bots.st/taskhold
Taskhold
Manage shared coding tasks and step progress
2793 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 22
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://taskhold.com/api/mcp
What it can do
| Tool | What it says it does |
|---|---|
taskhold_add_note | Add a note to a task: findings, decisions, what you tried. The person reads these. Notes are append-only and shown oldest first (taskhold_get shows the latest 10). Returns a one-line confirmation; an unknown task_id fails with "Task not found". |
taskhold_begin | Start work in one call: files a new task (or takes an existing one with task_id), plans its steps, marks it in progress and starts the first step. Use this whenever the person asks for something: it puts the request on their board with a checklist and a progress bar. Returns the task id, the… |
taskhold_block | Mark a task (or step) blocked when you can't continue without the person (a decision, missing info, access). Returns the question and the exact taskhold_updates call to wait with. Write the reason as one question they can answer from the board in a line, e.g. "Decide: drop the legacy column or… |
taskhold_complete | Mark a task or step done, with a summary of what you did and, optionally, a structured outcome: files changed (with +/- line counts), checks run (pass/fail/skip), links (PR, commit, branch, deploy, doc), follow-up task ids, risks and how the person can verify it. The person sees it as a What… |
taskhold_create | File work for later: a bug, a refactor, a follow-up you aren't doing now (it lands in To Do). To file and start work at once, use taskhold_begin. Pass parent_task_id to add one step to an existing task (taskhold_plan for several). Returns the new id, status (todo) and priority. Fails if… |
taskhold_create_from_todo | Create a task from a TODO comment in code, keeping the file path and line number (label todo-from-code plus any labels you pass; priority as in taskhold_create; use taskhold_create for anything else). Returns the new task with its id and code location. Fails at the account's task ceiling or on an… |
taskhold_create_project | Create a project (a group of tasks, usually one per repo). Optional: any tool that takes project creates it on first use. Returns the existing project if one has this name (case-insensitive), without changing it: the reply says if your description or color wasn't applied (taskhold_update_project… |
taskhold_get | Get one task with its full description, steps (subtasks), progress, labels and the latest notes. Returns status, priority, project, the numbered steps with ids (each with its description and, once done, its summary), up to 10 latest notes, the completion summary and what changed (files, checks… |
taskhold_get_current | Get the task in progress (in this project when you pass project), with its steps and the next one to do. Call this at the start of a session. Returns the most recently active in-progress task, its numbered steps with ids (with descriptions and the summaries of done steps), the next step's id and… |
taskhold_get_summary | Task counts by status, priority and who added them (human or agent). Returns the total and one list per grouping; counts top-level tasks only, not steps. |
taskhold_list | List top-level tasks, one line each, grouped by status. Pass project to see one repo's work. Each line has status, title, steps done, progress and id; steps aren't listed (taskhold_get shows them). An unknown project name returns no tasks and is not created. |
taskhold_list_labels | List the account's labels, one name per line. Labels are created by passing them to taskhold_create or taskhold_begin. |
taskhold_list_projects | List projects with their open work, one line each. You rarely need this: every tool takes project as a name. Each line has the name, open counts (working, blocked, todo) and id. |
taskhold_plan | Add ordered steps (subtasks) to a task so the person sees a checklist; the progress bar fills as steps finish. taskhold_begin already does this for new work. For an existing task: taskhold_start it, then taskhold_plan. Steps don't nest. Returns the task's whole step list with ids. Fails on an… |
taskhold_progress | Move the person's progress bar during a long step or a task without steps: percent, or current and total (e.g. 12 of 40 files), plus a short message about what's happening now. On a task with steps, the steps drive the bar: numbers you send for the task go to its running step. Call at milestones… |
taskhold_search | Search tasks and steps by text in the title or description (case-insensitive, up to 100 tasks scanned). Returns matching lines grouped by status, with ids (a step names the task it belongs to), or a line saying nothing matched. |
taskhold_set_priority | Change a task's priority. Returns the task title and new priority; an unknown task_id fails with "Task not found". |
taskhold_start | Mark a task or step in progress when you begin it. Starting a step also starts its task. For new work, taskhold_begin files, plans and starts in one call. Returns the id, status and the next step's id when it has steps. Safe to repeat; it also resumes a blocked or done task. An unknown task_id… |
taskhold_unblock | Move a blocked task back to todo once the blocker is resolved (taskhold_start resumes it directly). Returns the task with status todo. A task that isn't blocked is left as it is and the reply says its status; an unknown task_id fails with "Task not found". |
taskhold_update | Update a task's title, description, priority or project. Only fields you pass change; status goes through taskhold_start, taskhold_complete and taskhold_block. Returns the task as it is now. Fails on an unknown task_id, a project_id that doesn't exist (pass project by name instead) or an invalid… |
taskhold_update_project | Change a project's name, description or color. Only fields you pass change. Returns the project as it is now. Fails on an unknown project (it is never created here), on a name another project already has, or with nothing to change. |
taskhold_updates | What the person changed since you last looked: replies (notes), new tasks, priority changes, unblocks. Call when you resume, between steps, and after blocking (with wait, to hold until the reply lands). Pass the cursor from the previous call (or from taskhold_begin / taskhold_block) as since. Your… |
In its maker's words
Shared task list for Claude Code, Cursor and Codex: live progress per step, questions you answer.
- Website
- taskhold.com
- Publisher
- taskhold.com
- Listed from
- the official MCP Registry as
com.taskhold/taskhold - Version
- 1.0.4, updated 2 Nov 2026
- Kinds of work
- Productivity, Messaging and support, AI models and agent tools
The domain it lives on
- taskhold.com
- registered 17 Jul 2025 (1 year ago), at Squarespace Domains LLC, its name does not resolve now
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 2793 ms | |
| Answered | 1403 ms | |
| Answered | 1223 ms |
Next door
- Exogram — Personal AI Agent & WorkspacePlan meetings, drafts, and workspace content
- Nonlinear CalendarDeterministic nonlinear calendar and daily insights
- TaScanManage tasks, projects, and worker operations
- ainoteManage notes, tasks, and dev documents
- AutopoManage company inbox tasks and artifacts via API
Is this your bot? Claim its address to add a verified badge and keep the listing current.