> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Checkvist

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.

**Authentication:** Email + Remote API Key
**Categories:** Productivity, Project Management
**Tools:** 22: 7 read, 12 write, 3 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CHECKVIST)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'checkvist_checklist_export',
  toolInput: {
    checklist_id: 774394,
    format: 'opml',
  },
  connector: 'checkvist',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="checkvist_checklist_export",
    tool_input={
        "checklist_id": 774394,
        "format": "opml",
    },
    connection_name="checkvist",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `checkvist_checklist_export`

Export Checklist · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `format` (`string`, required): Export format: opml (full fidelity), md (Markdown) or txt. Example: md. One of: `opml`, `md`, `txt`.
- `export_color` (`boolean`, optional): opml only: include item priority/color. Example: false.
- `export_id` (`boolean`, optional): opml only: include each item's ID. Example: false.
- `export_notes` (`boolean`, optional): opml and md only: include item notes. Example: true.
- `export_status` (`boolean`, optional): opml only: include each item's open, closed or invalid status. Example: true.
- `max_heading` (`integer`, optional): md only: turn the first N outline levels (0 to 6) into Markdown headings. Example: 2.

Example input: `{"checklist_id":774394,"format":"opml"}`

### `checkvist_checklist_get`

Get Checklist · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `with_inbound_email` (`boolean`, optional): Include the list's email-to-list address as inbound_email. Example: false.

Example input: `{"checklist_id":774394}`

### `checkvist_checklists_list`

List Checklists · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `archived` (`boolean`, optional): Return archived lists instead of active ones. Example: false.
- `order` (`string`, optional): Override the sort order: id:asc, id:desc or updated_at:asc. Example: updated_at:asc. One of: `id:asc`, `id:desc`, `updated_at:asc`.
- `skip_stats` (`boolean`, optional): Faster response without per-list user and item counts. Example: true.
- `with_inbound_email` (`boolean`, optional): Include each list's email-to-list address as inbound_email. Example: false.

Example input: `{}`

### `checkvist_task_get`

Get Checklist Item · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.
- `with_notes` (`boolean`, optional): Include the notes attached to each item. Example: true.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_task_notes_list`

List Item Notes · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_tasks_list`

List Checklist Items · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `order` (`string`, optional): Override the sort order: id:asc, id:desc or updated_at:asc. Example: updated_at:asc. One of: `id:asc`, `id:desc`, `updated_at:asc`.
- `with_notes` (`boolean`, optional): Include the notes attached to each item. Example: true.

Example input: `{"checklist_id":774394}`

### `checkvist_user_get`

Get Current User · Read-only

Get the Checkvist user the credentials belong to.
Returns the user's id, username, email and settings.
Use this to confirm the connection works.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `checkvist_checklist_create`

Create Checklist · Write

Create a new list.
Returns the created list with its id.
Add items with checkvist_task_create or checkvist_tasks_import.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): List name. #tags in the name become list tags and are removed from the name. Example: Q3 launch plan.
- `public` (`string`, optional): 1 makes the list readable without login and indexable by search engines (PRO only); 0 makes it private. Example: 0. One of: `0`, `1`.
- `tags` (`string`, optional): Comma-separated list tags (letters, digits, _ and -). On update this replaces the existing tags; an empty value is ignored. Example: work,launch.

Example input: `{"name":"<name>"}`

### `checkvist_checklist_update`

Update Checklist · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `name` (`string`, optional): List name. #tags in the name become list tags and are removed from the name. Example: Q3 launch plan.
- `public` (`string`, optional): 1 makes the list readable without login and indexable by search engines (PRO only); 0 makes it private. Example: 0. One of: `0`, `1`.
- `tags` (`string`, optional): Comma-separated list tags (letters, digits, _ and -). On update this replaces the existing tags; an empty value is ignored. Example: work,launch.

Example input: `{"checklist_id":774394}`

### `checkvist_task_close`

Close Checklist Item · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_task_create`

Create Checklist Item · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `content` (`string`, required): Item text. Example: Draft the launch announcement.
- `due_date` (`string`, optional): Due date in Checkvist smart syntax, for example 2026-03-01, tomorrow, next friday or ^today. Example: 2026-03-01.
- `parent_id` (`integer`, optional): ID of the parent item, to nest this item under it. Example: 52834780.
- `position` (`integer`, optional): 1-based position among its siblings. Omit to add at the end. Example: 1.
- `priority` (`integer`, optional): Priority/color from 0 (none) to 9. Example: 1.
- `status` (`integer`, optional): Initial status: 0 open, 1 closed, 2 invalidated. Example: 0. One of: `0`, `1`, `2`.
- `tags` (`string`, optional): Comma-separated tags. Replaces all of the item's tags. Example: urgent,marketing.

Example input: `{"checklist_id":774394,"content":"<content>"}`

### `checkvist_task_invalidate`

Invalidate Checklist Item · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_task_note_create`

Add Item Note · Write

Add a note (comment) to a list item.
Returns the created note.
Use checkvist_task_notes_list to read existing notes.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `comment` (`string`, required): Note text. Example: Waiting on legal review.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"comment":"<comment>","task_id":52834781}`

### `checkvist_task_note_update`

Update Item Note · Write

Replace the text of a note on a list item.
Returns the updated note.
Get note IDs from checkvist_task_notes_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `comment` (`string`, required): New note text. Example: Legal review done.
- `note_id` (`integer`, required): Note ID, from checkvist_task_notes_list. Example: 3304511.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"comment":"<comment>","note_id":3304511,"task_id":52834781}`

### `checkvist_task_reopen`

Reopen Checklist Item · Write

Reopen a closed or invalidated item, and its children.
Returns the changed item and its children.
Get IDs from checkvist_tasks_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_task_repeat_set`

Set Item Repeat · Write

Make an item repeat daily, weekly, monthly or yearly from a start date.
Returns the updated item.
Get IDs from checkvist_tasks_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `period` (`string`, required): Repeat period. Example: weekly. One of: `daily`, `weekly`, `monthly`, `yearly`.
- `start_date` (`string`, required): Date of the first repeating due (YYYY-MM-DD). Example: 2026-02-02.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.
- `end_date` (`string`, optional): Date after which the item stops repeating (YYYY-MM-DD). Example: 2026-12-31.
- `period_count` (`integer`, optional): Repeat every N periods, e.g. 2 for every 2 weeks. Defaults to 1. Example: 2.

Example input: `{"checklist_id":774394,"period":"daily","start_date":"<start_date>","task_id":52834781}`

### `checkvist_task_tags_update`

Set or Remove Item Tags · Write

Set an item's tags, or remove one tag, optionally on several items at once.
Returns the affected items with their new tags.
Use delete_tag to remove one tag without resending the others. Use checkvist_task_update to set tags along with other fields.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.
- `delete_tag` (`string`, optional): Name of one tag to remove. Example: urgent.
- `tags` (`string`, optional): Space-separated tags to set on the item. Used only when delete_tag is not given. Example: urgent marketing.
- `task_ids` (`string`, optional): Comma-separated IDs of extra items to apply the same change to. Example: 52834782,52834783.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_task_update`

Update Checklist Item · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.
- `content` (`string`, optional): Item text. Example: Draft the launch announcement.
- `due_date` (`string`, optional): Due date in Checkvist smart syntax, for example 2026-03-01, tomorrow, next friday or ^today. Example: 2026-03-01.
- `parent_id` (`integer`, optional): ID of the parent item, to nest this item under it. Example: 52834780.
- `parse` (`boolean`, optional): Recognise ^due and #tags smart syntax in the new content. Example: true.
- `position` (`integer`, optional): 1-based position among its siblings. Example: 1.
- `priority` (`integer`, optional): Priority/color from 0 (none) to 9. Example: 1.
- `tags` (`string`, optional): Comma-separated tags. Replaces all of the item's tags. Example: urgent,marketing.
- `with_notes` (`boolean`, optional): Include the notes attached to each item. Example: true.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_tasks_import`

Import Checklist Items · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `checklist_id` (`string`, required): Target list ID, or tag:tagname to use the first list with that tag. Example: 774394.
- `import_content` (`string`, required): Items to import: one per line, indented to nest, or OPML. Example: Launch
  Write blog post
  Email customers.
- `import_content_note` (`string`, optional): Note to attach to the first imported item. Example: Imported from the planning doc.
- `parent_id` (`integer`, optional): Parent item to import under. Example: 52834780.
- `parse_tasks` (`boolean`, optional): Recognise smart syntax such as ^due, #tags and !priority in the items. Example: true.
- `position` (`integer`, optional): 1-based position of the first imported item. Example: 1.
- `replace_existing` (`boolean`, optional): Danger: replace the whole content of the list with the imported items. Example: false.
- `separate_with_empty_line` (`string`, optional): 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.
- `status` (`integer`, optional): Status for the first imported item: 0 open, 1 closed, 2 invalidated. Example: 0. One of: `0`, `1`, `2`.

Example input: `{"checklist_id":"<checklist_id>","import_content":"<import_content>"}`

### `checkvist_checklist_delete`

Delete Checklist · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.

Example input: `{"checklist_id":774394}`

### `checkvist_task_delete`

Delete Checklist Item · Destructive

Delete an item together with all its children.
Returns the deleted item.
Use checkvist_task_invalidate to strike it out instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"task_id":52834781}`

### `checkvist_task_note_delete`

Delete Item Note · Destructive

Delete a note from a list item.
Returns the deleted note.
Get note IDs from checkvist_task_notes_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `checklist_id` (`integer`, required): Checklist (list) ID, from checkvist_checklists_list. Example: 774394.
- `note_id` (`integer`, required): Note ID, from checkvist_task_notes_list. Example: 3304511.
- `task_id` (`integer`, required): List item (task) ID, from checkvist_tasks_list. Example: 52834781.

Example input: `{"checklist_id":774394,"note_id":3304511,"task_id":52834781}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
