Checkvist MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Checkvist MCP Server list all my checklists"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfiguration
Get your Checkvist API key from your profile page: https://checkvist.com/auth/profile
Create a
.envfile:
cp .env.example .envEdit
.envand add your credentials:
CHECKVIST_USERNAME=your_email@example.com
CHECKVIST_API_KEY=your_api_key_hereClaude 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 checklistcheckvist_update_checklist- Update checklist name or visibilitycheckvist_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 completecheckvist_reopen_task- Reopen completed taskcheckvist_delete_task- Delete task and childrencheckvist_invalidate_task- Mark task as invalidated (status=2)checkvist_set_repeating_task- Configure repeating task schedulecheckvist_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 taskcheckvist_update_note- Update existing notecheckvist_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
Recommended Workflows
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 pagesClaude 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 branchSmart 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 startAPI Documentation
Full Checkvist API docs: https://checkvist.com/auth/api
Available Tools
25 toolscheckvist_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_checklistADestructive
Delete a checklist (marks for deletion)
Inputs: checklist_id (required).
checkvist_delete_noteBDestructive
Delete a note/comment from a task
Inputs: note_id (required), task_id (required), checklist_id (required).
checkvist_delete_taskADestructive
Delete a task and its children
Inputs: task_id (required), checklist_id (required).
checkvist_get_checklistCRead-onlyIdempotent
Get information about a specific checklist by ID
Inputs: checklist_id (required).
checkvist_get_checklist_statsARead-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_userARead-onlyIdempotent
Get profile information for the authenticated user
Inputs: no named parameters.
checkvist_get_notesARead-onlyIdempotent
Get all notes/comments for a task
Inputs: task_id (required), checklist_id (required).
checkvist_get_taskARead-onlyIdempotent
Get a specific task by ID, including its parent hierarchy (returns JSON)
Inputs: task_id (required), checklist_id (required), with_notes.
checkvist_get_tasksARead-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_paginatedARead-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_summaryARead-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_treeARead-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_checklistsARead-onlyIdempotent
Get all checklists for the authenticated user. Can filter for archived lists.
Inputs: archived, skip_stats.
checkvist_list_top_level_tasksARead-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
Scored across 25 tools
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.
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.
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.
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
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted Mailchimp MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA MCP server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients.297-
- AlicenseAqualityDmaintenanceAn MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.5281 npm392MIT
- AlicenseNot gradedqualityDmaintenanceAn OAuth-authenticated MCP server that bridges Claude AI with a task management system, allowing users to list, create, and update tasks through natural language commands.1ISC
- AlicenseNot gradedqualityDmaintenanceA custom MCP server that connects Claude to Todoist using a permanent API token, avoiding OAuth re-authentication issues across all Claude surfaces.MIT