Developers

A workspace you can program

Every workspace ships a REST API with OpenAPI docs, scoped tokens, 27 HMAC-signed webhook events, portable automation JSON, and an MCP server with 258 tools. The UI is optional.

Read the docs

REST API, documented where it runs

Your workspace serves its own Swagger UI at /v1/docs and the OpenAPI schema at /v1/openapi.json. Tokens are per-user, scoped to read, write, or admin, and available from the Free plan up.

quickstart

# Scoped token from Settings → Integrations → API tokens
curl -H "Authorization: Bearer $TRUETASK_TOKEN" \
  https://your-workspace.truetask.io/v1/boards

27 events, signed and debuggable

Outgoing webhooks carry an HMAC signature and custom headers, with test deliveries and a per-hook delivery log so you're never guessing what fired.

card.createdcard.updatedcard.movedcard.completedcard.uncompletedcard.assignedcard.unassignedcard.deletedcard.comment_addedcomment.deletedchecklist.completedchecklist.uncompletedlist.createdlist.deletedboard.member_addedboard.member_removedtag.createdtag.deletedtime_entry.startedtime_entry.stoppedagent_run.handoffagent_run.completedagent_run.failedagent_run.blockedagent_run.needs_inputagent_run.cancelledaudit.log

258 MCP tools, on every plan

The full workspace surface (boards, cards, notes, time entries, automations, webhooks) exposed as governed MCP tools. Credentials are scoped per plan, from tasks & notes up to custom admin, so an assistant only touches what you allow. Works with Claude Code, Claude Desktop, Cursor, or any other MCP client.

Every workspace also serves a living /v1/agent-setup.md document an agent can read to onboard itself — the same content is exposed as an MCP resource.

mcp config

{
  "mcpServers": {
    "truetask": {
      "type": "http",
      "url": "https://your-workspace.truetask.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_CREDENTIAL" }
    }
  }
}

Editor & CLI

A VS Code extension keeps the current Truetask task in your status bar: start it with branch checkout guidance, open the cross-board review inbox and linked pull requests, and toggle the task timer without leaving the editor. A Zed setup wires the same MCP server and task commands natively. Both build on the truetask Python CLI, which has no dependencies outside the standard library.

truetask cli

# Point the CLI at your workspace
truetask auth setup --url https://your-workspace.truetask.io

# Branch name and checkout guidance for a task
truetask git start CARD_ID --create-remote

# Cross-board review inbox
truetask git reviews

Automations are portable JSON

Every automation graph exports as JSON and imports into any other board or workspace: 36 trigger types, 46+ action nodes, conditions, loops, even AI agent nodes. Build once, ship everywhere.

automation export

{
  "version": 1,
  "type": "truetask_automation",
  "name": "Triage new cards",
  "graph": { "nodes": [ … ], "edges": [ … ] }
}

Free plan includes API tokens and an MCP credential

Spin one up, point your agent at it, and see for yourself.

See what ships every week