JSPM

  • Created
  • Published
  • Downloads 1162
  • Score
    100M100P100Q127937F
  • License MIT

ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol

Package Exports

  • @taazkareem/clickup-mcp-server
  • @taazkareem/clickup-mcp-server/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@taazkareem/clickup-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ClickUp

MCP Server

A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.

Quick Start

Directions for use with Cursor Composer Agent:

  1. Get your credentials:
  2. Go to Features in settings
  3. Add under MCP Servers:
npx -y @taazkareem/clickup-mcp-server \
  --env CLICKUP_API_KEY=your_api_key_here \
  --env CLICKUP_TEAM_ID=your_team_id_here
  1. Replace the credentials and click Save
  2. Use Natural Language to interact with your ClickUp Workspace!

Features

  • 🎯 Task Management

    • Create, update, and delete individual tasks
    • Move and duplicate tasks between lists, spaces, and folders
    • Create multiple tasks in bulk
    • View and modify task details and properties
  • 📂 Workspace Organization

    • Complete workspace hierarchy (spaces, folders, lists)
    • Tree structure with clear relationships
    • Create and manage lists and folders
    • Efficient path-based navigation
  • 🔄 Integration Features

    • Name or ID-based item lookup
    • Case-insensitive name matching
    • Markdown formatting support
    • Built-in API rate limiting
  • 🤖 AI-Powered Analysis

    • Task status summaries and overviews
    • Priority analysis and recommendations
    • Structured description generation
    • Task relationship mapping

Available Tools

Tool Description Required Parameters
get_workspace_hierarchy Get workspace structure None
create_task Create a task name, (listId/listName)
create_bulk_tasks Create multiple tasks tasks[]
update_task Modify task taskId/taskName
get_tasks Get tasks from list listId/listName
get_task Get task details taskId/taskName
delete_task Remove task taskId
move_task Move task taskId/taskName, listId/listName
duplicate_task Copy task taskId/taskName, listId/listName
create_list Create list in space name, spaceId/spaceName
create_folder Create folder name, spaceId/spaceName
create_list_in_folder Create list in folder name, folderId/folderName

See full documentation for optional parameters and advanced usage.

Available Prompts

Prompt Purpose Features
summarize_tasks Task overview Status summary, priorities, relationships
analyze_priorities Priority optimization Distribution analysis, sequencing
generate_description Task description creation Objectives, criteria, dependencies

Error Handling

The server provides clear error messages for:

  • Missing required parameters
  • Invalid IDs or names
  • Items not found
  • Permission issues
  • API errors
  • Rate limiting

Support the Developer

If you find this project useful, please consider supporting

Sponsor TaazKareem

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.