The Checkvist connector lets your AI agent act in each user's Checkvist account. Each user connects their own Checkvist API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 22 tools.
- Tools
- 22
- What they doRead · write · destructive
- 7 · 12 · 37 read12 write3 destructive
- Users sign in with
- Username and password
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Checkvist connection
In AgentKit > Connections, create a Checkvist connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolcheckvist_checklist_exportExport a whole list as an OPML, Markdown or plain-text document.Read-onlyExport Checklist
Export a whole list as an OPML, Markdown or plain-text document. Returns the document text (not JSON). Use this to read or back up an entire outline at once. OPML keeps notes, tags, due dates and status; use checkvist_tasks_list for structured JSON items.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
formatstringrequired- Export format: opml (full fidelity), md (Markdown) or txt. Example: md.one of
opmlmdtxt export_colorboolean- opml only: include item priority/color. Example: false.
export_idboolean- opml only: include each item's ID. Example: false.
export_notesboolean- opml and md only: include item notes. Example: true.
export_statusboolean- opml only: include each item's open, closed or invalid status. Example: true.
max_headinginteger- md only: turn the first N outline levels (0 to 6) into Markdown headings. Example: 2.
checkvist_checklist_getGet one list's details.Read-onlyGet Checklist
Get one list's details. Returns the list's id, name, tags, item counts and options. Use checkvist_tasks_list for its items and checkvist_checklist_export for the whole list as Markdown, OPML or text.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
with_inbound_emailboolean- Include the list's email-to-list address as inbound_email. Example: false.
checkvist_checklists_listList your Checkvist lists, most recently updated first unless order is set.Read-onlyList Checklists
List your Checkvist lists, most recently updated first unless order is set. Returns each list's id, name, tags, item counts and update time. Use this to find a checklist ID. Set archived=true to see archived lists. Use checkvist_checklist_get for one list.
Inputs
archivedboolean- Return archived lists instead of active ones. Example: false.
orderstring- Override the sort order: id:asc, id:desc or updated_at:asc. Example: updated_at:asc.one of
id:ascid:descupdated_at:asc skip_statsboolean- Faster response without per-list user and item counts. Example: true.
with_inbound_emailboolean- Include each list's email-to-list address as inbound_email. Example: false.
checkvist_task_getGet one list item followed by its parents up to the root.Read-onlyGet Checklist Item
Get one list item followed by its parents up to the root. Returns an array: the item first, then each parent. Get IDs from checkvist_tasks_list.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
with_notesboolean- Include the notes attached to each item. Example: true.
checkvist_task_notes_listList the notes (comments) on a list item.Read-onlyList Item Notes
List the notes (comments) on a list item. Returns each note's id, text, author and timestamps. Use this to find a note ID to edit or delete.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_tasks_listList all items of a list, sorted by parent and position.Read-onlyList Checklist Items
List all items of a list, sorted by parent and position. Returns each item's id, content, parent_id, status, tags, due date, priority and assignees. Use this to read a list's outline. Use checkvist_task_get for one item and its parents.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
orderstring- Override the sort order: id:asc, id:desc or updated_at:asc. Example: updated_at:asc.one of
id:ascid:descupdated_at:asc with_notesboolean- Include the notes attached to each item. Example: true.
checkvist_user_getGet the Checkvist user the credentials belong to.Read-onlyGet Current User
Get the Checkvist user the credentials belong to. Returns the user's id, username, email and settings. Use this to confirm the connection works.
Inputs
This tool takes no inputs.
checkvist_checklist_createCreate a new list.WriteCreate Checklist
Create a new list. Returns the created list with its id. Add items with checkvist_task_create or checkvist_tasks_import.
Inputs
namestringrequired- List name. #tags in the name become list tags and are removed from the name. Example: Q3 launch plan.
publicstring- 1 makes the list readable without login and indexable by search engines (PRO only); 0 makes it private. Example: 0.one of
01 tagsstring- Comma-separated list tags (letters, digits, _ and -). On update this replaces the existing tags; an empty value is ignored. Example: work,launch.
checkvist_checklist_updateRename a list, change its public status or replace its tags.WriteUpdate Checklist
Rename a list, change its public status or replace its tags. Only the fields sent change. Returns the updated list. Get the ID from checkvist_checklists_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
namestring- List name. #tags in the name become list tags and are removed from the name. Example: Q3 launch plan.
publicstring- 1 makes the list readable without login and indexable by search engines (PRO only); 0 makes it private. Example: 0.one of
01 tagsstring- Comma-separated list tags (letters, digits, _ and -). On update this replaces the existing tags; an empty value is ignored. Example: work,launch.
checkvist_task_closeMark an item done (closed).WriteClose Checklist Item
Mark an item done (closed). For a parent item, all its children are closed too. Returns the changed item and its children. Get IDs from checkvist_tasks_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_task_createAdd one item to a list, optionally nested under a parent, with tags, a due date and priority.WriteCreate Checklist Item
Add one item to a list, optionally nested under a parent, with tags, a due date and priority. Returns the created item. Use checkvist_tasks_import to add many items or a whole outline at once.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
contentstringrequired- Item text. Example: Draft the launch announcement.
due_datestring- Due date in Checkvist smart syntax, for example 2026-03-01, tomorrow, next friday or ^today. Example: 2026-03-01.
parent_idinteger- ID of the parent item, to nest this item under it. Example: 52834780.
positioninteger- 1-based position among its siblings. Omit to add at the end. Example: 1.
priorityinteger- Priority/color from 0 (none) to 9. Example: 1.
statusinteger- Initial status: 0 open, 1 closed, 2 invalidated. Example: 0.one of
012 tagsstring- Comma-separated tags. Replaces all of the item's tags. Example: urgent,marketing.
checkvist_task_invalidateMark an item invalid (struck out as no longer relevant), and its children.WriteInvalidate Checklist Item
Mark an item invalid (struck out as no longer relevant), and its children. Returns the changed item and its children. Get IDs from checkvist_tasks_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_task_note_createAdd a note (comment) to a list item.WriteAdd Item Note
Add a note (comment) to a list item. Returns the created note. Use checkvist_task_notes_list to read existing notes.
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
commentstringrequired- Note text. Example: Waiting on legal review.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_task_note_updateReplace the text of a note on a list item.WriteUpdate Item Note
Replace the text of a note on a list item. Returns the updated note. Get note IDs from checkvist_task_notes_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
commentstringrequired- New note text. Example: Legal review done.
note_idintegerrequired- Note ID, from checkvist_task_notes_list. Example: 3304511.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_task_reopenReopen a closed or invalidated item, and its children.WriteReopen Checklist Item
Reopen a closed or invalidated item, and its children. Returns the changed item and its children. Get IDs from checkvist_tasks_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_task_repeat_setMake an item repeat daily, weekly, monthly or yearly from a start date.WriteSet Item Repeat
Make an item repeat daily, weekly, monthly or yearly from a start date. Returns the updated item. Get IDs from checkvist_tasks_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
periodstringrequired- Repeat period. Example: weekly.one of
dailyweeklymonthlyyearly start_datestringrequired- Date of the first repeating due (YYYY-MM-DD). Example: 2026-02-02.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
end_datestring- Date after which the item stops repeating (YYYY-MM-DD). Example: 2026-12-31.
period_countinteger- Repeat every N periods, e.g. 2 for every 2 weeks. Defaults to 1. Example: 2.
checkvist_task_updateChange an item's text, parent, tags, due date, position or priority.WriteUpdate Checklist Item
Change an item's text, parent, tags, due date, position or priority. Does not change its status. Returns the updated item. Use checkvist_task_close, checkvist_task_reopen or checkvist_task_invalidate to change status.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
contentstring- Item text. Example: Draft the launch announcement.
due_datestring- Due date in Checkvist smart syntax, for example 2026-03-01, tomorrow, next friday or ^today. Example: 2026-03-01.
parent_idinteger- ID of the parent item, to nest this item under it. Example: 52834780.
parseboolean- Recognise ^due and #tags smart syntax in the new content. Example: true.
positioninteger- 1-based position among its siblings. Example: 1.
priorityinteger- Priority/color from 0 (none) to 9. Example: 1.
tagsstring- Comma-separated tags. Replaces all of the item's tags. Example: urgent,marketing.
with_notesboolean- Include the notes attached to each item. Example: true.
checkvist_tasks_importAdd many items to a list from indented text or OPML, in one call.WriteImport Checklist Items
Add many items to a list from indented text or OPML, in one call. Items are added at the top unless a position or parent is given. Returns the created items as a hierarchy. Use this for outlines; indent child items. Large imports can take a minute; do not retry early or items may be duplicated.
Inputs
checklist_idstringrequired- Target list ID, or tag:tagname to use the first list with that tag. Example: 774394.
import_contentstringrequired- Items to import: one per line, indented to nest, or OPML. Example: Launch Write blog post Email customers.
import_content_notestring- Note to attach to the first imported item. Example: Imported from the planning doc.
parent_idinteger- Parent item to import under. Example: 52834780.
parse_tasksboolean- Recognise smart syntax such as ^due, #tags and !priority in the items. Example: true.
positioninteger- 1-based position of the first imported item. Example: 1.
replace_existingboolean- Danger: replace the whole content of the list with the imported items. Example: false.
separate_with_empty_linestring- singleItem imports all text as one item; any other value splits items at empty lines; omit to treat each line as an item. Example: singleItem.
statusinteger- Status for the first imported item: 0 open, 1 closed, 2 invalidated. Example: 0.one of
012
checkvist_checklist_deleteDelete a list with all its items.DestructiveDelete Checklist
Delete a list with all its items. The list is marked for deletion and erased within a day. Returns the deleted list. Get the ID from checkvist_checklists_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
checkvist_task_deleteDelete an item together with all its children.DestructiveDelete Checklist Item
Delete an item together with all its children. Returns the deleted item. Use checkvist_task_invalidate to strike it out instead.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
checkvist_task_note_deleteDelete a note from a list item.DestructiveDelete Item Note
Delete a note from a list item. Returns the deleted note. Get note IDs from checkvist_task_notes_list.
- Idempotent
Inputs
checklist_idintegerrequired- Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
note_idintegerrequired- Note ID, from checkvist_task_notes_list. Example: 3304511.
task_idintegerrequired- List item (task) ID, from checkvist_tasks_list. Example: 52834781.
No tools match.