Catto

Catto is an AI-first task manager. Tasks get auto-assigned CAT-N identifiers (e.g. CAT-42) for easy reference. Projects group tasks, custom statuses replace rigid workflows, and the built-in AI assistant can create, update, and complete tasks from natural language.

Key concepts:

• Task — a unit of work with a CAT-N identifier, status, priority, labels, and optional due date
• Project — a named container for tasks, with emoji + color
• Status — custom workflow states (system defaults: todo, in_progress, paused, backlog, completed, cancelled)
• Subtask — a task with a --parent reference; nested arbitrarily

Install

npm install -g catto-cli

Authenticate

Generate a token at app.catto.iopho.com → Settings → Integrations → CLI Token, then:

catto auth token rdk_your_token_here

CLI reference

Tasks

# List tasks
catto tasks                              # Active tasks (default)
catto tasks -s in_progress               # Filter by status
catto tasks -s "todo,in_progress"        # Multiple statuses
catto tasks -p 1                         # Filter by priority (1=urgent)
catto tasks --project <id>               # Filter by project
catto tasks --parent CAT-5               # Subtasks of CAT-5
catto tasks -d                           # Include done tasks
catto tasks -l 50                        # Limit results

# Get a task
catto tasks get CAT-42                   # By identifier
catto tasks get 42                       # By seq number

# Create a task
catto tasks create "Fix login bug"
catto tasks create "Research API" -s backlog -p 2 --project <id>
catto tasks create "Subtask" --parent CAT-10 --due 2026-05-01

# Update a task
catto tasks update CAT-42 -s in_progress
catto tasks update CAT-42 --notes "Added more context"

# Complete / delete
catto tasks complete CAT-42
catto tasks delete CAT-42

Priority levels:

Value	Meaning
0	None
1	Urgent
2	High
3	Medium
4	Low

Projects

catto projects                           # List all active projects
catto projects create                    # Interactive: name, emoji, color
catto projects update <id>               # Update name/emoji/color
catto projects update <id> --archive     # Archive a project

Statuses

catto statuses                           # List all statuses (system + custom)
catto statuses create in_review "In Review" -g active
catto statuses update <id> --label "Reviewing" --color "#FFB800"
catto statuses delete <id>               # Custom statuses only

AI chat

catto chat "What tasks are overdue?"
catto chat "Create a task to review the PRD by Friday"
catto chat "Mark all CAT-12 subtasks as done"

The AI assistant has full access to your tasks and can perform actions — create, update, complete — directly from the conversation.

Dashboard

catto status                             # Overview: task counts by status, upcoming due dates

MCP server

{
  "mcpServers": {
    "catto": {
      "command": "npx",
      "args": ["-y", "catto-cli", "mcp"],
      "env": {
        "CATTO_TOKEN": "rdk_your_token_here"
      }
    }
  }
}

MCP tools reference

Tasks (6 tools)

Tool	Description
catto_list_tasks	List tasks with filters (status, priority, project, parent, include-done)
catto_get_task	Get full task details by CAT-N, seq number, or UUID
catto_create_task	Create a task — returns assigned CAT-N identifier
catto_update_task	Update any field on a task (partial update)
catto_complete_task	Mark a task as completed
catto_delete_task	Soft-delete a task

Projects (4 tools)

Tool	Description
catto_list_projects	List all active projects
catto_create_project	Create a project with name, emoji, color
catto_update_project	Update a project (name, emoji, color, archive/unarchive)
catto_reorder_projects	Reorder projects by providing an ordered array of IDs

Statuses (4 tools)

Tool	Description
catto_list_statuses	List all statuses sorted by sort_order
catto_create_status	Create a custom status (system statuses are seeded automatically)
catto_update_status	Update label, color, or sort_order
catto_delete_status	Delete a custom status (must not be in use by any tasks)

Conversations (2 tools)

Tool	Description
catto_list_conversations	List AI chat conversations
catto_get_conversation_messages	Get messages in a conversation

Chat (1 tool)

Tool	Description
catto_send_message	Send a message to the Catto AI assistant — creates or continues a conversation. Can create/update/complete tasks.

Tip

The catto_send_message tool is the most powerful entry point. Tell it “create a task for X with high priority due Friday” and it handles the full intent → action pipeline without needing individual tool calls.

→ PAT Tokens for non-interactive setup