# Taskhold MCP server

Source: https://glimind.com/server/mcp-registry%2Fcom.taskhold%2Ftaskhold
Registry id: `mcp-registry/com.taskhold/taskhold`
Status: live (checked 2026-11-22T17:11:24.572Z)

## Measurements (30 days)

- Uptime: 99.44%
- Checks: 953
- Outages (90 days): 1

## Install

```json
{
  "mcpServers": {
    "taskhold-mcp-server": {
      "type": "http",
      "url": "https://taskhold.com/api/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http taskhold-mcp-server https://taskhold.com/api/mcp
```

## Tools (24)

- `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 1
- `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 when
- `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
- `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
- `taskhold_create`: File 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 (taskhol
- `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;
- `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. A project with this name (any case) co
- `taskhold_get`: Get one task in full: status, priority, project, labels, repeat, time worked and waited on the person, description, numbered steps with ids and summaries, the 1
- `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 r
- `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 are
- `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, block
- `taskhold_next`: Work 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 sam
- `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. Fo
- `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'
- `taskhold_release`: Put 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, prog
- `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 st
- `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. Retur
- `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
- `taskhold_update`: Change a task's title, description, priority, project or repeat; only fields you pass change. Status goes through taskhold_start, taskhold_complete, taskhold_bl
- `taskhold_update_project`: Change 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 
- `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 (

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
