A shared task list for Windsurf (Devin Desktop)

Setup

• Start the 7-day trial and open Settings. Click to make a setup URL. It looks like https://taskhold.com/setup/<token>.md and expires after 3 days.
• Paste it into your agent with the words "set this up". The agent fetches the markdown, which contains a fresh API key, the config for its own client and the task workflow snippet.
• The agent adds the server, then calls taskhold_list to check it works. Settings shows "Connected" when the first call arrives.

By hand: current Devin Desktop docs put the file at ~/.config/devin/mcp_config.json on macOS and Linux (%APPDATA%\devin\mcp_config.json on Windows). Older Windsurf installs use ~/.codeium/windsurf/mcp_config.json. Add:

{
  "mcpServers": {
    "taskhold": {
      "serverUrl": "https://taskhold.com/api/mcp",
      "headers": { "Authorization": "Bearer <your atd_sk_ key>" }
    }
  }
}

Then turn the server on from the MCPs section of the agent panel's menu.

Workflow snippet

Add this to your rules or AGENTS.md:

## Tasks (Taskhold)

The human and I share a task list through the taskhold MCP tools.
- Session start: taskhold_get_current; if nothing is in progress, taskhold_list status:todo and take the highest priority.
- taskhold_start before working on a task; taskhold_add_note as you go.
- Can't continue? taskhold_block with the reason. Done? taskhold_complete with a short summary.
- Found a TODO or a bug you aren't fixing now? taskhold_create (or taskhold_create_from_todo with file and line).

What the agent can do

• taskhold_get_current: what is already in progress, so a new session picks up where the last one stopped.
• taskhold_list and taskhold_start: take the highest-priority todo and mark it in progress, so a second agent skips it.
• taskhold_add_note: leave notes on the task as work goes, visible in the web app.
• taskhold_block: stop with a reason. The task shows as blocked on you in Agent Activity.
• taskhold_complete: finish with a short summary of what changed.
• taskhold_create and taskhold_create_from_todo: file new tasks, including a TODO with its file path and line number.