Tokanban

Get started with Tokanban

Connect your tools to start managing tasks through your agent or CLI.

Go to dashboard Read the docs

Install the CLI

The Tokanban CLI gives you full task management from your terminal.

cargo install tokanban tokanban auth login
# Installs a pre-built binary when available curl -fsSL https://app.tokanban.com/install.sh | sh tokanban auth login

The install script downloads the latest matching release when available and falls back to cargo install otherwise.

tokanban auth login opens your browser for authentication. Your API key is stored locally at ~/.config/tokanban/config.toml.

Connect your AI agent

Add Tokanban as an MCP server so your agent can create, query, and update tasks directly.

Add to your Claude Code MCP configuration (~/.claude.json or via claude mcp add):

{ "mcpServers": { "tokanban": { "type": "url", "url": "https://api.tokanban.com/mcp", "headers": { "Authorization": "Bearer <your-api-key>" } } } }

Replace <your-api-key> with the key from the previous step.

Add to your Codex CLI MCP configuration (~/.codex/config.json):

{ "mcpServers": { "tokanban": { "type": "url", "url": "https://api.tokanban.com/mcp", "headers": { "Authorization": "Bearer <your-api-key>" } } } }

Replace <your-api-key> with the key from the previous step. Restart Codex CLI to pick up the change.

In Cursor, go to Settings > MCP Servers and add a remote server:

Name: tokanban Type: URL URL: https://api.tokanban.com/mcp Headers: Authorization: Bearer <your-api-key>

The MCP server is a remote HTTP endpoint. Point any MCP-compatible tool at:

URL: https://api.tokanban.com/mcp Auth: Authorization: Bearer <your-api-key> Method: POST (JSON-RPC 2.0)

The server exposes task, memory, project admin, sprint, and visualization tools. Discover them via the tools/list method.

Enable agent memory

Tokanban memory is opt-in. Use an agent key with memory:read and memory:write, then add the harness behavior block so the agent starts and ends sessions correctly.

Add the memory block to CLAUDE.md and keep the project/workdir roots together when both are known:

## Tokanban Memory At session start: 1. Call session_start 2. Call memory_relevant_now During work: - treat new findings as candidates first - explicit remember request -> write now - durable and ready -> memory_create_fact / memory_create_decision - otherwise defer to session end - memory_supersede - flag_contradiction At session end: 1. If available, run tokanban memory candidate review 2. Call session_end 3. Clear only the returned candidate ids after success 4. Include a continuation prompt

If your current agent key predates memory support, rotate or recreate it so the key includes memory:read and memory:write.

Add the memory block to AGENTS.md and keep the working directory stable so workdir memory stays useful across sessions:

## Agent Memory (Tokanban) Use project_id for shared board context. Use working_directory for repo/worktree context. Use both when both are known. Start: session_start -> memory_relevant_now Write now only for explicit requests or clearly durable, ready items Defer the rest with tokanban memory candidate add Review them with tokanban memory candidate review before session_end Stop: session_end with a continuation prompt

Add the memory block to .cursorrules so Cursor sessions read and write Tokanban memory consistently:

## Tokanban Memory When a coding session starts: 1. Call session_start 2. Call memory_relevant_now Treat findings and choices as candidates first. Write durable memory only when it is clearly ready, otherwise defer it. Before stopping, run tokanban memory candidate review when available, then call session_end.

Verify it works

Try creating your first task:

Pick a default project once, then task commands can omit --project.

# Pick a default project tokanban project list tokanban project set PLAT # Create a task tokanban task create "Set up CI/CD pipeline" --priority High # List tasks tokanban task list # View task detail tokanban task view PLAT-1

Ask your agent:

"Create a task in Tokanban: Set up CI/CD pipeline, priority High" "List all my Tokanban tasks" "Show me the Tokanban sprint board"

The agent uses the MCP tools automatically. No special syntax needed.

curl -X POST https://api.tokanban.com/v1/projects/:id/tasks \ -H "Authorization: Bearer <your-api-key>" \ -H "Content-Type: application/json" \ -d '{"title":"Set up CI/CD pipeline","priority":"High"}'

Next steps

Go to dashboard Read the docs