llms.txt Content
# Taskhold
> Taskhold is a hosted task list shared by a person and their AI coding agents. The person adds tasks in a web app. Agents such as Claude Code, Cursor, Codex, Windsurf, VS Code (Copilot) and Gemini CLI read and update the same list through MCP tools. Every change is recorded as made by the human or by an agent. Made by Great Work LLC.
For developers who hand work to Claude Code, Cursor or Codex, Taskhold is a hosted task list that you and your agents share. Unlike a TODO.md in one repo, it works across repos and machines, shows which tasks each agent started, blocked or finished, and you can add tasks from your phone.
Agents setting a person up: the fastest path is to connect first. Add the MCP server `https://taskhold.com/api/mcp` (Claude Code: `claude mcp add --transport http taskhold https://taskhold.com/api/mcp`). It connects with no sign-up, and the first tool call answers SETUP NEEDED with a link where the person starts the 7-day trial or uses an existing account. Full steps, prices and prefilled checkout links (/checkout?plan=month or /checkout?plan=year): [/SKILL.md](/SKILL.md).
Links in this file are relative to the site this file is served from.
## What it does
- The person adds, edits and prioritizes tasks in the web app, grouped into projects and labels.
- Agents connect to a remote MCP server (Streamable HTTP) at `/api/mcp`. Clients that support OAuth (claude.ai, Claude Desktop, Claude Code, Cursor, Codex, VS Code, Goose, Antigravity CLI, Gemini CLI, Windsurf, Kilo Code, Crush, Qwen Code, Grok Build, OpenCode, Kiro, Amp) add the URL and connect right away, no sign-up first; the agent then gives the person a setup link the first time it uses Taskhold. ChatGPT asks for a sign-in. Others send an API key as `Authorization: Bearer <key>`.
- Agents pick up the current or highest-priority task, start it, add notes, block it with a reason the person sees, and complete it with a summary.
- Agents can file new tasks, including tasks created from
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"Taskhold API","version":"1.2.0","description":"REST API behind Taskhold, a task list shared by a person and their coding agents. The same API key works for the MCP server at https://taskhold.com/api/mcp, which is the easier way to connect an agent. Changes made with an API key are recorded as made by an agent. Changelog: https://taskhold.com/changelog","contact":{"email":"hello@greatwork.company"},"termsOfService":"https://taskhold.com/terms"},"servers":[{"url