Skip to main content
Checkvist logo
  • Category: model context protocol
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 16
  • Triggers: 0
  • Slug: CHECKVIST
  • Version: 20261101_00

Tools

Slug: CHECKVIST_CREATE_CHECKLISTCreate a Checkvist checklist with a name and optional visibility and tags.

Input Parameters

string
required
Name for the new checklist.
string
Comma-separated checklist tags.
boolean
Whether to make the checklist public.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_CREATE_TASKCreate a task in a checklist, optionally under a parent and with tags, smart-syntax due date, position, priority, or assignees.

Input Parameters

string
Comma-separated tag set.
string
required
Task text content.
string
Due date in Checkvist smart syntax.
integer
1-based position.
integer
Priority from 0 through 9.
integer
Optional parent task ID.
array
User IDs to assign to the task.
integer
required
ID of the checklist in which to create the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_DELETE_CHECKLISTMark a Checkvist checklist for deletion. This destructive operation affects the checklist and all data it contains.

Input Parameters

integer
required
ID of the checklist to mark for deletion.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_DELETE_TASKPermanently delete a Checkvist task and all of its child tasks. This is a destructive operation and cannot be undone with this tool.

Input Parameters

integer
required
ID of the task to delete together with its children.
integer
required
ID of the checklist containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_GET_CHECKLISTGet one Checkvist checklist’s metadata by ID. Use Get Tasks Outline to read the checklist’s tasks.

Input Parameters

integer
required
ID of the checklist to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_GET_TASKS_OUTLINERead 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

boolean
Return only task IDs and titles, omitting metadata and notes.
boolean
Return only top-level tasks without subtasks.
integer
Maximum subtask depth to include; 99 shows all depths.
integer
required
ID of the checklist whose tasks to read.
boolean
Include closed tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_GET_TASKS_PAGERead 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

integer
required
1-based page number. Each page contains one top-level task and its subtree.
boolean
Use compact output.
integer
Maximum subtree depth. Use 2-3 for large branches or 99 for all depths.
integer
required
ID of the checklist whose tasks to page through.
boolean
Return only each task ID and the first 40 title characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_GET_TASK_TREERead 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

boolean
Use shorter compact output.
integer
required
ID of the root task to read.
integer
Maximum depth to show; lower values constrain large results.
boolean
Include notes; this can make the result much larger.
integer
required
ID of the checklist containing the task.
boolean
Include closed tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_IMPORT_TASKSCreate 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

integer
Parent task ID under which to import the new hierarchy.
boolean
Parse Checkvist smart syntax such as ^due, #tags, and !priority in indented text. Defaults to false.
integer
required
ID of the checklist to import tasks into.
string
required
Checkvist indented text only. One task appears per line and spaces or tabs create hierarchy. Use Replace Tasks for OPML imports.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_LIST_CHECKLISTSList 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

boolean
If true, return archived checklists.
boolean
If true, execute faster but omit checklist statistics.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_REPLACE_TASKSDelete 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

boolean
Parse Checkvist smart syntax such as ^due, #tags, and !priority in indented text. Defaults to false.
integer
required
ID of the checklist whose complete task hierarchy to replace.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_SEARCH_TASKSSearch 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

integer
1-based results page; each page contains up to 50 matches.
string
required
Search words and supported Checkvist operators: ^/due:, #/tag:, in:, and has:note. Other operator-like text is matched literally.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_SET_TASK_STATUSSet a task’s status to closed, reopened, or invalidated using Checkvist’s dedicated status operations.

Input Parameters

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.
integer
required
ID of the task whose status to change.
integer
required
ID of the checklist containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_UPDATE_CHECKLISTUpdate 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

string
New checklist name.
string
Comma-separated replacement tag set; an empty string removes all tags.
boolean
Whether the checklist should be public.
integer
required
ID of the checklist to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_UPDATE_TASKUpdate 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

string
Comma-separated replacement tag set; an empty string removes all tags.
boolean
Parse smart syntax for due dates and tags.
string
New task text.
integer
required
ID of the task to update.
string
Due date in Checkvist smart syntax; an empty string clears it.
integer
New 1-based position.
integer
Priority from 0 through 9.
integer
New parent task ID.
array
Replacement assignee user IDs.
integer
required
ID of the checklist containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CHECKVIST_UPDATE_TASK_TAGSAdd 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

array
Plain tag names to add, without ’#’. An explicit empty array is preserved.
array
Plain tag names to remove, without ’#’. An explicit empty array is preserved.
integer
required
ID of the task whose tags to modify.
integer
required
ID of the checklist containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not