Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Checkvist

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Checkvist connection

    In AgentKit > Connections, create a Checkvist connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • checkvist_checklist_exportExport a whole list as an OPML, Markdown or plain-text document.Read-only

    Export 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-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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-only

    List 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-only

    Get 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.Write

    Create 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.