A shared task list for Windsurf (Devin Desktop)
By Jake Marsh, who builds Taskhold. Updated 2026-11-11. Facts about other tools checked 2026-11-11. 4 min read.
Cognition renamed Windsurf to Devin Desktop in June 2026. The MCP setup works the same way: a JSON file listing servers, and remote servers with headers are supported.
Taskhold gives its agent a task list you share. You queue tasks in the web app, the agent works through them over MCP, and the live board shows its steps, progress and questions, with notes, blocks and summaries on each task. The MCP config generator writes the JSON for you, and the quickstart walks through the first run.
Setup
Open the file with Open MCP config file in Cascade's MCP menu. Current docs put it at ~/.config/devin/mcp_config.json on macOS and Linux (%APPDATA%\devin\mcp_config.json on Windows). The editor's MCP discovery reads a separate file, ~/.codeium/windsurf/mcp_config.json. Add the server with no key:
{
"mcpServers": {
"taskhold": {
"serverUrl": "https://taskhold.com/api/mcp"
}
}
}Turn the server on from the MCPs section of the agent panel's menu (Cascade's docs say to press refresh there after adding a server). When taskhold shows Needs authentication, click Authenticate and finish in your browser; in Devin CLI the same step is devin mcp login taskhold. It connects with no sign-up, and the first time the agent uses Taskhold it gives you a link to start the 7-day trial (or to use your existing account).
With an API key instead, for a machine with no browser: make a setup URL in Taskhold Settings, paste it into Cascade and say "set this up" (it carries a new key and expires after 3 days), or add the header yourself:
"headers": { "Authorization": "Bearer <your atd_sk_ key>" }Write the host as taskhold.com, never www.taskhold.com: the www address redirects, and the redirect drops the header.
Rules for Cascade
Cascade reads an AGENTS.md at the workspace root as an always-on rule, and one in a subfolder as guidance for work in that folder. Workspace rules in .windsurf/rules work too, and global_rules.md applies to every workspace; each rules file is capped at 12,000 characters. Add this to the root AGENTS.md:
# Taskhold
This workspace's tasks live in the taskhold MCP server, and the person watches them on a live board.
Use project: "<repo folder name>" in all taskhold calls.
When a conversation starts, read taskhold_get_current and taskhold_updates (save the cursor).
Begin each request with taskhold_begin, giving title, project, steps and agent: "Windsurf in <repo>". Pick up queued work through taskhold_list (status todo) and taskhold_begin with task_id.
Mark steps done with taskhold_complete (start_next: true). Send taskhold_progress on long ones, every few minutes at most.
Blocked: taskhold_block with a single question, then taskhold_updates with task_id, since and wait: 50.
Done: taskhold_complete with a summary of changes and checks. Deferred bugs and TODOs: taskhold_create or taskhold_create_from_todo.Watch the agent's progress outside the editor
Cascade's panel shows the conversation in front of you. The live board, open in any browser, shows the plan Cascade made, the step it is on and any question it left you. How to monitor a coding agent's progress goes through the board, and the MCP tools reference explains each call the rule asks for.
How do I keep the key out of mcp_config.json?
Cascade interpolates environment variables in command, args, env, serverUrl, url and headers, written as ${env:NAME}. Keep the key in an environment variable instead of the config:
{
"mcpServers": {
"taskhold": {
"serverUrl": "https://taskhold.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:TASKHOLD_API_KEY}" }
}
}
}To hide Taskhold tools you don't use, list them in disabledTools inside the taskhold entry. Keep the ones live progress runs on: taskhold_list, taskhold_get_current, taskhold_begin, taskhold_start, taskhold_plan, taskhold_progress, taskhold_block, taskhold_updates and taskhold_complete.
"disabledTools": ["taskhold_list_labels", "taskhold_set_priority", "taskhold_search"]On a Teams or Enterprise plan, an admin can turn MCP off or allow only approved servers. If Taskhold doesn't appear in the MCPs list, ask them to add https://taskhold.com/api/mcp.
Disconnecting Cascade
Cascade sends Taskhold only task text, steps, progress and notes. Turn the server off in the MCPs list to pause it, or delete the taskhold entry to remove it. Revoking its key in Taskhold Settings > API keys ends access at once with 401.
For a server that stays red or never lists its tools, see Windsurf MCP server not connecting.
Answer your coding agents from anywhere.
$12/month or $120/year after the trial. Card up front. Cancel before day 7 and you pay nothing. Every agent you run is included.
Or connect your agent first, no sign-up: add https://taskhold.com/api/mcp as an MCP server. The first time it uses Taskhold, it gives you the trial link.
Questions
- Is this the same as Windsurf?
- Yes. Cognition renamed Windsurf to Devin Desktop on June 2, 2026. Setup is the same remote MCP server either way.
- Is my code sent to Taskhold?
- No. Only the task text, notes, and any file path and line number the agent attaches.
- What does it cost?
- Taskhold is $12 a month or $120 a year for each person, with a 7-day trial that needs a card.
Sources
- Devin docs: Windsurf Cascade MCP configuration (mcp_config.json, interpolation, admin allowlist), checked 2026-11-11
- Devin docs: Devin Desktop MCP (Streamable HTTP and SSE with OAuth, Authenticate), checked 2026-11-11
- Devin CLI docs: MCP authentication (dynamic client registration, devin mcp login), checked 2026-11-11
- Devin docs: Cascade AGENTS.md, checked 2026-11-11
- Devin docs: Cascade memories and rules (global_rules.md, .windsurf/rules, 12,000 characters), checked 2026-11-11
Related
- Cursor task list over MCP: watch every task live
- How to see what Claude Code is doing, live
- VS Code Copilot task list over MCP: watch it live
- How to hand tasks to your coding agent
- Windsurf MCP server not connecting: the fix
- Task managers for AI coding agents, compared
- Windsurf Cascade hook: each reply on the board
Updated 2026-11-11. Something wrong or out of date? Email hello@greatwork.company.