For agents

Your agents work here too

createtodo speaks the interfaces coding agents already use: an MCP server, a JSON‑first CLI, and an installable skill that teaches the agent the conventions. A todo filed by an agent is the todo you see in the app — same workspace, same real‑time sync.

Everything authenticates with a workspace API key, created in the app under Settings → API Keys. Give each agent its own key, and it can track work across sessions without a chat client running.

MCP server

Structured tools for any MCP client

@createtodo/mcp covers todos and subtodos, lists, labels, comments, dependencies, workflow states, members, and workspace health.

Hosted endpoint

Nothing to install — point a Streamable HTTP client at the hosted server with your API key as a Bearer token:

https://api.createtodo.com/mcp
Authorization: Bearer <your-api-key>

For example, in Claude Code:

claude mcp add --transport http createtodo https://api.createtodo.com/mcp \
  --header "Authorization: Bearer $CREATETODO_API_KEY"

Run it locally

Prefer a local process? The same server runs over stdio from npm — add it to any MCP client config:

{
  "mcpServers": {
    "createtodo": {
      "command": "npx",
      "args": ["-y", "@createtodo/mcp"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}
Command line

The ct command, JSON first

@createtodo/cli — a CLI is a cheaper agent interface than a tool‑calling protocol, returning compact text the agent can filter before it costs context.
npm install -g @createtodo/cli
ct login                      # stores your API key locally
ct ready                      # actionable work: open, no unresolved blockers
ct claim MZ-123               # assign to yourself and start it
ct close MZ-123               # done — response lists newly unblocked todos

Manage todos from the terminal. Every command prints JSON, so results pipe straight into jq, git hooks, or an agent’s context. Dependencies make the loop self‑organizing: ct dep add MZ-124 MZ-123 means MZ‑124 waits on MZ‑123, ct ready hides blocked work, and closing a blocker reports what it freed up. ct health surfaces stale, orphaned, and thin todos before they rot. Run ct help for the full command surface.

Agent skill

Teach the agent the conventions

Reference todos by identifier, never invent one, write real descriptions, and flag human decisions instead of guessing.
ct skill install claude-code   # also: codex, cursor, gemini, universal

A CLI is only half the story — the agent also needs to know how to use it well. One command installs a skill file that teaches your coding agent the commands and the conventions that matter. For Claude Code there is session priming on top: ct init wires ct prime to run on session start, so the agent opens every session already knowing what is in progress, what is ready, and what the rules are.

Ready to put an agent to work?

Create an API key in the app, hand it to your agent, and watch the todos move on their own.

Open app