Agents Index

Taskhold

Online

Shared task list for Claude Code, Cursor and Codex: live progress per step, questions you answer.

Visit publisherConnectJSON

What it can do: 24 tools

  • taskhold_beginStart 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 t
  • taskhold_list read-onlyList 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 nam
  • taskhold_get read-onlyGet one task in full: status, priority, project, labels, repeat, time worked and waited on the person, description, numbered steps with ids and summaries, the 10 latest notes, the completion summary and what changed (fil
  • taskhold_get_current read-onlyGet 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
  • taskhold_nextWork the list as a queue: takes the next To Do task (highest priority, then oldest by default) and starts it and its first step. Atomic: no 2 agents get the same task. Returns the task, steps, project notes and next call
  • taskhold_search read-onlySearch 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 m
  • taskhold_createFile work for later (a bug, a follow-up, a chore); it lands in To Do. To file and start at once: taskhold_begin. parent_task_id adds one step to a task (taskhold_plan for several). Returns id, status and priority. Fails
  • taskhold_planAdd 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. S
  • taskhold_progressMove 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 b
  • taskhold_create_from_todoCreate 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 tas
  • taskhold_startMark 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.
  • taskhold_completeMark 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 i
  • taskhold_blockMark 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 ca
  • taskhold_unblockMove 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
  • taskhold_releasePut unfinished work back in To Do, with a note, when you stop and nobody has to answer (e.g. waiting on a captcha). Its steps go too, your label comes off, progress stays. Need the person? taskhold_block. Done tasks are
  • taskhold_updateChange a task's title, description, priority, project or repeat; only fields you pass change. Status goes through taskhold_start, taskhold_complete, taskhold_block and taskhold_release. Returns the task. Fails on an unkn
  • taskhold_add_noteAdd 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 fail
  • taskhold_set_priorityChange a task's priority. Returns the task title and new priority; an unknown task_id fails with "Task not found".
  • taskhold_updates read-onlyWhat 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, until the reply lands). Pass the last cursor you
  • taskhold_list_projects read-onlyList 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. With project: that project's notes.
  • taskhold_create_projectCreate a project (a group of tasks, usually one per repo). Optional: any tool that takes project creates it on first use. A project with this name (any case) comes back unchanged, and the reply says if your description o
  • taskhold_update_projectChange a project's name, description, color or project notes. 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,
  • taskhold_list_labels read-onlyList the account's labels, one name per line. Labels are created by passing them to taskhold_create or taskhold_begin.
  • taskhold_get_summary read-onlyTask 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.

Connect it

Claude Code
claude mcp add --transport http taskhold https://taskhold.com/api/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://taskhold.com/api/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "taskhold": {
      "url": "https://taskhold.com/api/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "taskhold": {
      "type": "http",
      "url": "https://taskhold.com/api/mcp"
    }
  }
}

Questions

What does Taskhold do?

Shared task list for Claude Code, Cursor and Codex: live progress per step, questions you answer. It exposes 24 tools to AI assistants.

What tools does Taskhold provide?

24 tools, including taskhold_begin, taskhold_list, taskhold_get, taskhold_get_current, taskhold_next, taskhold_search, taskhold_create, taskhold_plan, taskhold_progress, taskhold_create_from_todo, taskhold_start, taskhold_complete….

How do I connect Taskhold to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://taskhold.com/api/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Taskhold require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Taskhold online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Taskhold?

taskhold.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Productivity & Docs