Tools

Five tools. One creates, two read, two edit.

Creating

create_pipeline

Creates a project and its ordered stages in one call.

FieldTypeNotes
namestringRequired. The pipeline name.
overviewstringShort description shown on the project.
briefstringLonger context behind the pipeline.
categorystringOptional label, up to 40 characters.
linkstringOptional external http(s) URL.
owner_emailstringThe OneTap user who owns it. Ignored for OAuth callers, who always own what they create.
stages[]arrayRequired, 1–25 items. Each takes title (required), description, goal, achievement, priority (low | medium | high) and dueDate (YYYY-MM-DD).

The owner is seeded as lead and auto-assigned to every stage. The latest stage dueDate becomes the project deadline.

Reading

list_pipelines

Lists the caller's pipelines with their id, status, dates and stage count.

FieldTypeNotes
owner_emailstringOptional. Whose pipelines to list, for bearer-token callers.

get_pipeline

Returns one pipeline's dates and status, plus every stage's id, title, status, priority and due date.

FieldTypeNotes
pipeline_idstringRequired.

This is how you find a stage_id before editing a stage.

Editing

Both editors are partial: only the fields you pass change.

update_stage

Edits one stage.

FieldTypeNotes
stage_idstringRequired.
due_datestringYYYY-MM-DD, or an empty string to clear the date.
statusenumtodo | in_progress | in_review | done
priorityenumlow | medium | high
title, description, goal, achievementstringStage copy fields.

update_pipeline

Edits project-level fields.

FieldTypeNotes
pipeline_idstringRequired.
name, overview, category, linkstringProject copy fields.
start_date, end_datestringYYYY-MM-DD, or an empty string to clear.
statusenumactive | on_hold | completed | archived