---
canonical_url: "https://docs.composio.dev/toolkits/checkvist"
markdown_url: "https://docs.composio.dev/toolkits/checkvist.md"
product: "platform"
version: null
last_updated: null
---

# Checkvist

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

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

## Tools

### Create Checklist

**Slug:** `CHECKVIST_CREATE_CHECKLIST`

Create a Checkvist checklist with a name and optional visibility and tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the new checklist. |
| `tags` | string | No | Comma-separated checklist tags. |
| `public` | boolean | No | Whether to make the checklist public. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | string | No | Comma-separated tag set. |
| `content` | string | Yes | Task text content. |
| `due_date` | string | No | Due date in Checkvist smart syntax. |
| `position` | integer | No | 1-based position. |
| `priority` | integer | No | Priority from 0 through 9. |
| `parent_id` | integer | No | Optional parent task ID. |
| `assignee_ids` | array | No | User IDs to assign to the task. |
| `checklist_id` | integer | Yes | ID of the checklist in which to create the task. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `checklist_id` | integer | Yes | ID of the checklist to mark for deletion. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | integer | Yes | ID of the task to delete together with its children. |
| `checklist_id` | integer | Yes | ID of the checklist containing the task. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `checklist_id` | integer | Yes | ID of the checklist to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `compact` | boolean | No | Return only task IDs and titles, omitting metadata and notes. |
| `preview` | boolean | No | Return only top-level tasks without subtasks. |
| `max_depth` | integer | No | Maximum subtask depth to include; 99 shows all depths. |
| `checklist_id` | integer | Yes | ID of the checklist whose tasks to read. |
| `include_closed` | boolean | No | Include closed tasks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tasks Page

**Slug:** `CHECKVIST_GET_TASKS_PAGE`

Read one explicit 1-based page of a large Checkvist checklist. Each page contains one top-level task and its subtree. Call again with another page number to continue; Checkvist does not provide a verified continuation signal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | Yes | 1-based page number. Each page contains one top-level task and its subtree. |
| `compact` | boolean | No | Use compact output. |
| `max_depth` | integer | No | Maximum subtree depth. Use 2-3 for large branches or 99 for all depths. |
| `checklist_id` | integer | Yes | ID of the checklist whose tasks to page through. |
| `ultra_compact` | boolean | No | Return only each task ID and the first 40 title characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `compact` | boolean | No | Use shorter compact output. |
| `task_id` | integer | Yes | ID of the root task to read. |
| `max_depth` | integer | No | Maximum depth to show; lower values constrain large results. |
| `with_notes` | boolean | No | Include notes; this can make the result much larger. |
| `checklist_id` | integer | Yes | ID of the checklist containing the task. |
| `include_closed` | boolean | No | Include closed tasks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `parent_id` | integer | No | Parent task ID under which to import the new hierarchy. |
| `parse_tasks` | boolean | No | Parse Checkvist smart syntax such as ^due, #tags, and !priority in indented text. Defaults to false. |
| `checklist_id` | integer | Yes | ID of the checklist to import tasks into. |
| `import_content` | string | Yes | Checkvist indented text only. One task appears per line and spaces or tabs create hierarchy. Use Replace Tasks for OPML imports. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `archived` | boolean | No | If true, return archived checklists. |
| `skip_stats` | boolean | No | If true, execute faster but omit checklist statistics. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `parse_tasks` | boolean | No | Parse Checkvist smart syntax such as ^due, #tags, and !priority in indented text. Defaults to false. |
| `checklist_id` | integer | Yes | ID of the checklist whose complete task hierarchy to replace. |
| `import_content` | string | Yes | Replacement hierarchy as Checkvist indented text or an OPML document. OPML can also replace the checklist name and tags from its title. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | 1-based results page; each page contains up to 50 matches. |
| `query` | string | Yes | Search words and supported Checkvist operators: ^/due:, #/tag:, in:, and has:note. Other operator-like text is matched literally. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("closed" | "reopened" | "invalidated") | Yes | Target transition: closed completes the task, reopened reopens it, and invalidated marks it as no longer applicable without completing it. |
| `task_id` | integer | Yes | ID of the task whose status to change. |
| `checklist_id` | integer | Yes | ID of the checklist containing the task. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New checklist name. |
| `tags` | string | No | Comma-separated replacement tag set; an empty string removes all tags. |
| `public` | boolean | No | Whether the checklist should be public. |
| `checklist_id` | integer | Yes | ID of the checklist to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | string | No | Comma-separated replacement tag set; an empty string removes all tags. |
| `parse` | boolean | No | Parse smart syntax for due dates and tags. |
| `content` | string | No | New task text. |
| `task_id` | integer | Yes | ID of the task to update. |
| `due_date` | string | No | Due date in Checkvist smart syntax; an empty string clears it. |
| `position` | integer | No | New 1-based position. |
| `priority` | integer | No | Priority from 0 through 9. |
| `parent_id` | integer | No | New parent task ID. |
| `assignee_ids` | array | No | Replacement assignee user IDs. |
| `checklist_id` | integer | Yes | ID of the checklist containing the task. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `add` | array | No | Plain tag names to add, without '#'. An explicit empty array is preserved. |
| `remove` | array | No | Plain tag names to remove, without '#'. An explicit empty array is preserved. |
| `task_id` | integer | Yes | ID of the task whose tags to modify. |
| `checklist_id` | integer | Yes | ID of the checklist containing the task. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |