> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkvist

> Checkvist beta PRO MCP lets AI assistants manage hierarchical lists, tasks, tags, due dates, and assignees, and read task notes.

![Checkvist logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/checkvist.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=0390302895b125d254cf9a697a0a90ed)

* **Category:** model context protocol
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 16
* **Triggers:** 0
* **Slug:** `CHECKVIST`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Checklist
>
> **Slug:** `CHECKVIST_CREATE_CHECKLIST`
>
> Create a Checkvist checklist with a name and optional visibility and tags.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the new checklist.
>
> **tags** `string`
>
> Comma-separated checklist tags.
>
> **public** `boolean`
>
> Whether to make the checklist public.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task
>
> **Slug:** `CHECKVIST_CREATE_TASK`
>
> Create a task in a checklist, optionally under a parent and with tags, smart-syntax due date, position, priority, or assignees.
>
> #### Input Parameters
>
> **tags** `string`
>
> Comma-separated tag set.
>
> **content** `string` *required*
>
> Task text content.
>
> **due\_date** `string`
>
> Due date in Checkvist smart syntax.
>
> **position** `integer`
>
> 1-based position.
>
> **priority** `integer`
>
> Priority from 0 through 9.
>
> **parent\_id** `integer`
>
> Optional parent task ID.
>
> **assignee\_ids** `array`
>
> User IDs to assign to the task.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist in which to create the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Checklist
>
> **Slug:** `CHECKVIST_DELETE_CHECKLIST`
>
> Mark a Checkvist checklist for deletion. This destructive operation affects the checklist and all data it contains.
>
> #### Input Parameters
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist to mark for deletion.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task
>
> **Slug:** `CHECKVIST_DELETE_TASK`
>
> Permanently delete a Checkvist task and all of its child tasks. This is a destructive operation and cannot be undone with this tool.
>
> #### Input Parameters
>
> **task\_id** `integer` *required*
>
> ID of the task to delete together with its children.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist containing the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Checklist
>
> **Slug:** `CHECKVIST_GET_CHECKLIST`
>
> Get one Checkvist checklist's metadata by ID. Use Get Tasks Outline to read the checklist's tasks.
>
> #### Input Parameters
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tasks Outline
>
> **Slug:** `CHECKVIST_GET_TASKS_OUTLINE`
>
> Read a checklist as a recommended markdown task outline, with controls for closed tasks, depth, compact output, or top-level preview. Checkvist requires a PRO account or active PRO trial for MCP tool execution.
>
> #### Input Parameters
>
> **compact** `boolean`
>
> Return only task IDs and titles, omitting metadata and notes.
>
> **preview** `boolean`
>
> Return only top-level tasks without subtasks.
>
> **max\_depth** `integer`
>
> Maximum subtask depth to include; 99 shows all depths.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist whose tasks to read.
>
> **include\_closed** `boolean`
>
> Include closed tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tasks Page
>
> **Slug:** `CHECKVIST_GET_TASKS_PAGE`
>
> Read one 1-based page of a Checkvist checklist, containing a top-level task and its subtree subject to a depth limit. Output is compact by default; request another page to continue, as no verified continuation signal is provided.
>
> #### Input Parameters
>
> **page** `integer` *required*
>
> 1-based page number. Each page contains one top-level task and its subtree.
>
> **compact** `boolean`
>
> Use compact output.
>
> **max\_depth** `integer`
>
> Maximum subtree depth. Use 2-3 for large branches or 99 for all depths.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist whose tasks to page through.
>
> **ultra\_compact** `boolean`
>
> Return only each task ID and the first 40 title characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Tree
>
> **Slug:** `CHECKVIST_GET_TASK_TREE`
>
> Read one Checkvist task and its subtasks as a markdown outline, optionally including closed items or notes and limiting depth. Checkvist requires a PRO account or active PRO trial for MCP tool execution.
>
> #### Input Parameters
>
> **compact** `boolean`
>
> Use shorter compact output.
>
> **task\_id** `integer` *required*
>
> ID of the root task to read.
>
> **max\_depth** `integer`
>
> Maximum depth to show; lower values constrain large results.
>
> **with\_notes** `boolean`
>
> Include notes; this can make the result much larger.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist containing the task.
>
> **include\_closed** `boolean`
>
> Include closed tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Import Tasks
>
> **Slug:** `CHECKVIST_IMPORT_TASKS`
>
> Create multiple hierarchical tasks from Checkvist indented text. Large imports can take at least a minute and must not be retried early because a retry can duplicate tasks. This tool preserves existing tasks; use Replace Tasks to delete and replace the checklist's current task hierarchy.
>
> #### Input Parameters
>
> **parent\_id** `integer`
>
> Parent task ID under which to import the new hierarchy.
>
> **parse\_tasks** `boolean`
>
> Parse Checkvist smart syntax such as ^due, #tags, and !priority in indented text. Defaults to false.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist to import tasks into.
>
> **import\_content** `string` *required*
>
> Checkvist indented text only. One task appears per line and spaces or tabs create hierarchy. Use Replace Tasks for OPML imports.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Checklists
>
> **Slug:** `CHECKVIST_LIST_CHECKLISTS`
>
> List checklists available to the authenticated Checkvist user, optionally including archived lists or omitting statistics for a faster response. Checkvist requires a PRO account or active PRO trial for MCP tool execution.
>
> #### Input Parameters
>
> **archived** `boolean`
>
> If true, return archived checklists.
>
> **skip\_stats** `boolean`
>
> If true, execute faster but omit checklist statistics.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Replace Tasks
>
> **Slug:** `CHECKVIST_REPLACE_TASKS`
>
> Delete every existing task in a checklist, then replace the hierarchy from Checkvist indented text or OPML. OPML can also replace the checklist name and tags. Large replacements can take at least a minute and must not be retried early because a retry can duplicate tasks.
>
> #### Input Parameters
>
> **parse\_tasks** `boolean`
>
> Parse Checkvist smart syntax such as ^due, #tags, and !priority in indented text. Defaults to false.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist whose complete task hierarchy to replace.
>
> **import\_content** `string` *required*
>
> Replacement hierarchy as Checkvist indented text or an OPML document. OPML can also replace the checklist name and tags from its title.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Tasks
>
> **Slug:** `CHECKVIST_SEARCH_TASKS`
>
> Search tasks across the user's Checkvist checklists using words and operators for due date (^ or due:), tag (# or tag:), state (in:), and notes (has:note). Returns one explicit 1-based page of up to 50 matches.
>
> #### Input Parameters
>
> **page** `integer`
>
> 1-based results page; each page contains up to 50 matches.
>
> **query** `string` *required*
>
> Search words and supported Checkvist operators: ^/due:, #/tag:, in:, and has:note. Other operator-like text is matched literally.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Task Status
>
> **Slug:** `CHECKVIST_SET_TASK_STATUS`
>
> Set a task's status to closed, reopened, or invalidated using Checkvist's dedicated status operations.
>
> #### Input Parameters
>
> **status** `string ("closed" | "reopened" | "invalidated")` *required*
>
> Target transition: closed completes the task, reopened reopens it, and invalidated marks it as no longer applicable without completing it.
>
> **task\_id** `integer` *required*
>
> ID of the task whose status to change.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist containing the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Checklist
>
> **Slug:** `CHECKVIST_UPDATE_CHECKLIST`
>
> Update an existing checklist's name, visibility, or complete tag set. At least one update field is required. An empty tags string removes all checklist tags.
>
> #### Input Parameters
>
> **name** `string`
>
> New checklist name.
>
> **tags** `string`
>
> Comma-separated replacement tag set; an empty string removes all tags.
>
> **public** `boolean`
>
> Whether the checklist should be public.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task
>
> **Slug:** `CHECKVIST_UPDATE_TASK`
>
> Update task content, hierarchy, replacement tags, due date, position, priority, assignees, or smart-syntax parsing. At least one update field is required. Use Set Task Status for completion state.
>
> #### Input Parameters
>
> **tags** `string`
>
> Comma-separated replacement tag set; an empty string removes all tags.
>
> **parse** `boolean`
>
> Parse smart syntax for due dates and tags.
>
> **content** `string`
>
> New task text.
>
> **task\_id** `integer` *required*
>
> ID of the task to update.
>
> **due\_date** `string`
>
> Due date in Checkvist smart syntax; an empty string clears it.
>
> **position** `integer`
>
> New 1-based position.
>
> **priority** `integer`
>
> Priority from 0 through 9.
>
> **parent\_id** `integer`
>
> New parent task ID.
>
> **assignee\_ids** `array`
>
> Replacement assignee user IDs.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist containing the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task Tags
>
> **Slug:** `CHECKVIST_UPDATE_TASK_TAGS`
>
> Add and remove task tags without replacing the complete tag set. Tag values are plain words without '#'. At least one of add or remove must be non-empty.
>
> #### Input Parameters
>
> **add** `array`
>
> Plain tag names to add, without '#'. An explicit empty array is preserved.
>
> **remove** `array`
>
> Plain tag names to remove, without '#'. An explicit empty array is preserved.
>
> **task\_id** `integer` *required*
>
> ID of the task whose tags to modify.
>
> **checklist\_id** `integer` *required*
>
> ID of the checklist containing the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
