mcpengine/servers/clickup

ClickUp MCP Server

Complete Model Context Protocol server for ClickUp - the all-in-one productivity platform.

Features

• 70+ Tools across all ClickUp domains
• 25 React Apps for rich interactive UIs
• Full API Coverage: Tasks, Spaces, Folders, Lists, Views, Comments, Docs, Goals, Tags, Time Tracking, Teams, Webhooks, Custom Fields, Templates, and Guests
• Production Ready: Rate limiting, pagination, error handling, comprehensive types

Installation

npm install @mcpengine/clickup

Configuration

Add to your MCP settings:

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/@mcpengine/clickup/dist/index.js"],
      "env": {
        "CLICKUP_API_TOKEN": "your-api-token"
      }
    }
  }
}

Authentication

ClickUp MCP supports two authentication methods:

1. Personal API Token (recommended for development):

   • Get your token from: https://app.clickup.com/settings/apps
   • Set CLICKUP_API_TOKEN environment variable

2. OAuth2 (for production apps):

   • Set CLICKUP_CLIENT_ID, CLICKUP_CLIENT_SECRET, and CLICKUP_OAUTH_TOKEN

Available Tools

Tasks (17 tools)

• clickup_tasks_list - List tasks with filtering
• clickup_tasks_get - Get task details
• clickup_tasks_create - Create new task
• clickup_tasks_update - Update task
• clickup_tasks_delete - Delete task
• clickup_tasks_filter - Advanced task filtering
• clickup_tasks_bulk_update - Bulk update tasks
• clickup_tasks_get_time_entries - Get time entries for task
• clickup_tasks_add_time_entry - Add time entry
• clickup_tasks_get_custom_fields - Get custom field values
• clickup_tasks_set_custom_field - Set custom field value
• clickup_tasks_add_dependency - Add task dependency
• clickup_tasks_remove_dependency - Remove dependency
• clickup_tasks_list_members - List task members
• clickup_tasks_add_comment - Add comment to task
• clickup_tasks_get_comments - Get task comments
• clickup_tasks_search - Search tasks

Spaces (5 tools)

• clickup_spaces_list - List spaces
• clickup_spaces_get - Get space details
• clickup_spaces_create - Create space
• clickup_spaces_update - Update space
• clickup_spaces_delete - Delete space

Folders (5 tools)

• clickup_folders_list - List folders
• clickup_folders_get - Get folder details
• clickup_folders_create - Create folder
• clickup_folders_update - Update folder
• clickup_folders_delete - Delete folder

Lists (7 tools)

• clickup_lists_list - List lists
• clickup_lists_get - Get list details
• clickup_lists_create - Create list
• clickup_lists_update - Update list
• clickup_lists_delete - Delete list
• clickup_lists_add_task - Add task to list
• clickup_lists_remove_task - Remove task from list

Views (5 tools)

• clickup_views_list - List views
• clickup_views_get - Get view details
• clickup_views_create - Create view
• clickup_views_update - Update view
• clickup_views_delete - Delete view

Comments (5 tools)

• clickup_comments_list - List comments
• clickup_comments_get - Get comment
• clickup_comments_create - Create comment
• clickup_comments_update - Update comment
• clickup_comments_delete - Delete comment

Docs (3 tools)

• clickup_docs_list - List docs
• clickup_docs_get - Get doc
• clickup_docs_create - Create doc
• clickup_docs_search - Search docs

Goals (7 tools)

• clickup_goals_list - List goals
• clickup_goals_get - Get goal
• clickup_goals_create - Create goal
• clickup_goals_update - Update goal
• clickup_goals_delete - Delete goal
• clickup_goals_add_key_result - Add key result
• clickup_goals_update_key_result - Update key result

Tags (5 tools)

• clickup_tags_list - List tags
• clickup_tags_create - Create tag
• clickup_tags_update - Update tag
• clickup_tags_delete - Delete tag
• clickup_tags_add_to_task - Add tag to task

Checklists (6 tools)

• clickup_checklists_create - Create checklist
• clickup_checklists_update - Update checklist
• clickup_checklists_delete - Delete checklist
• clickup_checklists_create_item - Create checklist item
• clickup_checklists_update_item - Update item
• clickup_checklists_delete_item - Delete item

Time Tracking (7 tools)

• clickup_time_list_entries - List time entries
• clickup_time_get_entry - Get time entry
• clickup_time_create - Create time entry
• clickup_time_update - Update time entry
• clickup_time_delete - Delete time entry
• clickup_time_get_running - Get running timer
• clickup_time_start - Start timer
• clickup_time_stop - Stop timer

Teams (6 tools)

• clickup_teams_list_workspaces - List workspaces
• clickup_teams_get_workspace - Get workspace
• clickup_teams_list_members - List members
• clickup_teams_get_member - Get member
• clickup_teams_list_groups - List groups
• clickup_teams_create_group - Create group

Webhooks (4 tools)

• clickup_webhooks_list - List webhooks
• clickup_webhooks_create - Create webhook
• clickup_webhooks_update - Update webhook
• clickup_webhooks_delete - Delete webhook

Custom Fields (4 tools)

• clickup_custom_fields_list - List custom fields
• clickup_custom_fields_get - Get custom field
• clickup_custom_fields_set_value - Set field value
• clickup_custom_fields_remove_value - Remove value

Templates (2 tools)

• clickup_templates_list - List templates
• clickup_templates_apply - Apply template

Guests (6 tools)

• clickup_guests_invite - Invite guest
• clickup_guests_get - Get guest
• clickup_guests_edit - Edit guest
• clickup_guests_remove - Remove guest
• clickup_guests_add_to_task - Add guest to task
• clickup_guests_add_to_list - Add guest to list

Available Apps

Task Management

• task-dashboard - Overview with status counts, overdue, priority breakdown
• task-detail - Full task view with subtasks, comments, custom fields, time entries, dependencies
• task-grid - Sortable/filterable task list
• task-board - Kanban board by status (drag-drop)

Workspace & Organization

• space-overview - Space with folders, lists, members
• folder-overview - Folder with lists and task summaries
• list-view - List detail with task table
• workspace-overview - High-level workspace stats

Views & Visualization

• calendar-view - Tasks on calendar by due date
• gantt-view - Timeline/gantt of tasks with dependencies
• sprint-board - Sprint-style task board with velocity

Goals & Tracking

• goal-tracker - Goals with key results progress bars
• time-dashboard - Time tracking overview, entries by date/member
• time-entries - Time entry list with task associations
• member-workload - Per-member task counts, time logged, overdue

Content & Collaboration

• doc-browser - Document list with search
• comment-thread - Threaded comments for a task
• checklist-manager - Checklists with item completion
• tag-manager - Tag list with task counts
• custom-fields-editor - Custom field values on a task

Utilities

• template-gallery - Available templates with preview
• search-results - Universal search across tasks/docs
• activity-feed - Recent changes across workspace

API Coverage

This server implements the complete ClickUp API v2:

• https://clickup.com/api/clickupapiref/operation/GetTasks/
• Rate limiting and pagination handled automatically
• Comprehensive error handling and retries

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

License

MIT