Skip to main content
Glama
Checkvist MCP Server

Checkvist MCP Server

by mats-i

Checkvist MCP Server

MCP server for Checkvist API integration, enabling Claude to read and write to Checkvist checklists.

Features

  • Complete checklist CRUD operations (list, get, create, update, delete)

  • Complete task management (create, update, close, reopen, delete, invalidate)

  • Repeating task configuration

  • Task assignment to users

  • Import multiple tasks at once

  • Complete notes/comments management (get, create, update, delete)

  • User profile information

  • Full support for Checkvist's smart syntax (^due dates, #tags, !priority)

  • Helpful error messages with actionable tips

Related MCP server: Todoist MCP Server

Installation

npm install
npm run build

Configuration

  1. Get your Checkvist API key from your profile page: https://checkvist.com/auth/profile

  2. Create a .env file:

cp .env.example .env
  1. Edit .env and add your credentials:

CHECKVIST_USERNAME=your_email@example.com
CHECKVIST_API_KEY=your_api_key_here

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "checkvist": {
      "command": "node",
      "args": [
        "/Users/matsingerdal/Developer/GitHub/checkvist-mcp/dist/index.js"
      ]
    }
  }
}

Available Tools

Checklist Management

  • checkvist_list_checklists - Get all checklists (read-only)

  • checkvist_get_checklist - Get specific checklist info (read-only)

  • checkvist_create_checklist - Create a new checklist

  • checkvist_update_checklist - Update checklist name or visibility

  • checkvist_delete_checklist - Delete checklist (marks for deletion)

Task Management

  • checkvist_get_tasks - Get all tasks as raw JSON (read-only)

  • checkvist_get_tasks_summary - Get all tasks in readable text format (read-only)

  • checkvist_get_tasks_paginated - Get tasks in pages to read entire large checklists (RECOMMENDED, read-only)

  • checkvist_get_task - Get specific task with parent hierarchy as JSON (read-only)

  • checkvist_get_task_tree - Get a specific task and ALL its subtasks in readable text (read-only)

  • checkvist_create_task - Create a new task (supports assignee_ids)

  • checkvist_update_task - Update existing task (supports assignee_ids)

  • checkvist_close_task - Mark task as complete

  • checkvist_reopen_task - Reopen completed task

  • checkvist_delete_task - Delete task and children

  • checkvist_invalidate_task - Mark task as invalidated (status=2)

  • checkvist_set_repeating_task - Configure repeating task schedule

  • checkvist_import_tasks - Import multiple tasks at once

Notes/Comments

  • checkvist_get_notes - Get all notes for a task (read-only)

  • checkvist_create_note - Add a note to a task

  • checkvist_update_note - Update existing note

  • checkvist_delete_note - Delete a note

User Information

  • checkvist_get_current_user - Get authenticated user profile (read-only)

Reading Large Checklists

For large checklists with many tasks, use the right approach based on checklist size:

Strategy 1: Quick Preview (BEST for VERY large checklists) ⭐

checkvist_get_tasks_summary with preview: true

  • Shows ONLY top-level tasks (no subtasks)

  • Minimal data, perfect for huge checklists (1000+ tasks)

  • Automatically uses compact mode

  • Get quick overview, then drill down with get_task_tree

  • Example:

    checkvist_get_tasks_summary(
      checklist_id: 941803,
      preview: true
    )
  • Output:

    šŸ“‹ Checklist Summary (5 top-level tasks, 847 total)
    ⚔ PREVIEW MODE: Showing only top-level tasks
    
    [ ] Main Project [12345]
    [ ] Archive [12350]
    [ ] Notes [12351]
    [ ] Resources [12352]
    [ ] Templates [12353]
    
    šŸ’” TIP: Use checkvist_get_task_tree with a specific task ID to explore subtasks

Strategy 2: See Full Structure (for medium/large checklists)

checkvist_get_tasks_summary with compact: true

  • Shows ENTIRE checklist in ultra-compact format

  • Only displays: status, title, and ID (no metadata, no notes)

  • Works for hundreds of tasks

  • Example:

    checkvist_get_tasks_summary(
      checklist_id: 941803,
      compact: true,
      max_depth: 2
    )

Strategy 3: Explore Specific Branches

checkvist_get_task_tree (for detailed view of one branch)

  • Get ONE specific task and ALL its subtasks with full details

  • Shows metadata, notes, due dates, priorities, tags

  • Perfect when you found interesting task in compact view

  • Example: checkvist_get_task_tree(checklist_id: 941803, task_id: 71218558)

Strategy 4: Full Details for Smaller Checklists

checkvist_get_tasks_summary with compact: false (default)

  • Shows everything with full metadata and notes

  • Only use for checklists with <50 tasks

  • May be too large for bigger checklists

checkvist_get_tasks

  • Returns raw JSON structure

  • May be stored in files that are harder to read

  • Use only when you need to process JSON programmatically

Option 1: Read Everything in Pages ⭐ (BEST for reading entire checklist)

1. checkvist_get_tasks_paginated(checklist_id: X, page: 1)
   → Shows first 3 top-level tasks with ALL their subtasks
2. checkvist_get_tasks_paginated(checklist_id: X, page: 2)
   → Shows next 3 top-level tasks with ALL their subtasks
3. Continue until you've read all pages

Claude can read ALL tasks this way without hitting size limits!

Option 2: Preview + Drill Down (faster for finding specific info)

1. checkvist_get_tasks_summary(checklist_id: X, preview: true)
   → See all top-level tasks (just 5-10 items)
2. Find interesting task in the preview
3. checkvist_get_task_tree(checklist_id: X, task_id: Y)
   → Get all details for that specific branch

Smart Syntax Support

Checkvist supports smart syntax in task content:

  • ^tomorrow - Set due date

  • #tag - Add tag

  • !3 - Set priority (0-9)

  • @username - Assign to user

Enable parsing with parse_tasks: true or parse: true parameters.

Development

# Watch mode
npm run dev

# Build
npm run build

# Start
npm start

API Documentation

Full Checkvist API docs: https://checkvist.com/auth/api

Available Tools

25 tools
checkvist_close_taskC

Close/complete a task

Inputs: task_id (required), checklist_id (required).

checkvist_create_checklistB

Create a new checklist

Inputs: name (required), tags, public.

checkvist_create_noteB

Create a note/comment on a task

Inputs: comment (required), task_id (required), checklist_id (required).

checkvist_create_taskB

Create a new task in a checklist

Inputs: content (required), checklist_id (required), tags, due_date, +4 more.

checkvist_delete_checklistA
Destructive

Delete a checklist (marks for deletion)

Inputs: checklist_id (required).

checkvist_delete_noteB
Destructive

Delete a note/comment from a task

Inputs: note_id (required), task_id (required), checklist_id (required).

checkvist_delete_taskA
Destructive

Delete a task and its children

Inputs: task_id (required), checklist_id (required).

checkvist_get_checklistC
Read-onlyIdempotent

Get information about a specific checklist by ID

Inputs: checklist_id (required).

checkvist_get_checklist_statsA
Read-onlyIdempotent

Get statistics about a checklist: number of tasks, top-level tasks, average depth, etc. Use this first to understand checklist size.

Inputs: checklist_id (required).

checkvist_get_current_userA
Read-onlyIdempotent

Get profile information for the authenticated user

Inputs: no named parameters.

checkvist_get_notesA
Read-onlyIdempotent

Get all notes/comments for a task

Inputs: task_id (required), checklist_id (required).

checkvist_get_taskA
Read-onlyIdempotent

Get a specific task by ID, including its parent hierarchy (returns JSON)

Inputs: task_id (required), checklist_id (required), with_notes.

checkvist_get_tasksA
Read-onlyIdempotent

Get all tasks from a checklist as raw JSON. Use checkvist_get_tasks_summary instead for easier reading. Only use this when you need the complete JSON data structure.

Inputs: checklist_id (required), with_notes.

checkvist_get_tasks_paginatedA
Read-onlyIdempotent

Get ALL tasks in chunks to avoid size limits. Returns a specific page of top-level tasks with their subtasks. Call multiple times with different page numbers to read entire checklist.

Inputs: page (required), checklist_id (required), compact, max_depth, +1 more.

checkvist_get_tasks_summaryA
Read-onlyIdempotent

Get tasks from a checklist in a readable text format (RECOMMENDED). For VERY LARGE checklists: use preview=true to see only top-level tasks. For large checklists: use compact=true to show all tasks with titles+IDs only. For small checklists: use default to see full details.

Inputs: checklist_id (required), compact, preview, max_depth, +1 more.

checkvist_get_task_treeA
Read-onlyIdempotent

Get a specific task and its subtasks in readable text format. Use max_depth to limit size if needed.

Inputs: task_id (required), checklist_id (required), compact, max_depth, +2 more.

checkvist_import_tasksA

Import multiple tasks at once in Checkvist format (indented text)

Inputs: checklist_id (required), import_content (required), parent_id, parse_tasks.

checkvist_invalidate_taskA

Mark a task as invalidated (status=2, different from closed)

Inputs: task_id (required), checklist_id (required).

checkvist_list_checklistsA
Read-onlyIdempotent

Get all checklists for the authenticated user. Can filter for archived lists.

Inputs: archived, skip_stats.

checkvist_list_top_level_tasksA
Read-onlyIdempotent

Get ONLY the list of top-level task IDs and titles (no subtasks). Use this to get an overview, then use checkvist_get_task_tree to read each one individually.

Inputs: checklist_id (required).

checkvist_reopen_taskA

Reopen a closed task

Inputs: task_id (required), checklist_id (required).

checkvist_set_repeating_taskC

Configure a task to repeat on a schedule

Inputs: period (required), task_id (required), checklist_id (required), since, +2 more.

checkvist_update_checklistC

Update an existing checklist

Inputs: checklist_id (required), name, public.

checkvist_update_noteC

Update an existing note/comment

Inputs: comment (required), note_id (required), task_id (required), checklist_id (required).

checkvist_update_taskC

Update an existing task

Inputs: task_id (required), checklist_id (required), tags, parse, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 25 tools

    Disambiguation3/5

    There are several overlapping task retrieval tools (get_tasks, get_tasks_summary, get_tasks_paginated, list_top_level_tasks, get_task, get_task_tree) that differ mainly in output format and verbosity. The descriptions help, but an agent could easily select the wrong one, especially for large checklists.

    Naming Consistency5/5

    All 25 tools follow the consistent pattern checkvist_<verb>_<noun>, with clear verbs like get, list, create, update, delete, close, reopen. No mixed conventions or vague names.

    Tool Count3/5

    25 tools is on the heavy side for a checklist app. Many retrieval variants (raw JSON, summary, paginated, top-level, task tree) could be consolidated into fewer tools, reducing cognitive load without losing functionality.

    Completeness4/5

    The tool surface covers CRUD for checklists, tasks, and notes, plus useful extras like stats, import, and repeating tasks. However, there is no explicit archive/restore checklist operation (despite filtering by archived) and no task reordering/moving, which are common in outliner apps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers