@cwmeepo/clickup-mcp v2.0.1

@meepo/clickup-mcp

A Cursor-compatible MCP server for ClickUp integration, allowing seamless interaction with ClickUp tasks and workspaces through natural language.

Installation

This is a restricted package. To install it:

1. Contact the package owner to get access to the package
2. Once granted access, authenticate with npm:

npm login

Then you can install the package:

# Install globally
npm install -g @meepo/clickup-mcp

# Or install locally in a project
npm install @meepo/clickup-mcp

Configuration

Local Repository Configuration

To simplify working with ClickUp in a local repository, you can create an mcp-config.json file in your repository root. This allows you to configure default IDs for the ClickUp workspace hierarchy specific to this repository.

Example mcp-config.json:

{
  "clickup": {
    "workspaceId": "123",
    "spaceId": "456",
    "listId": "101112"
  }
}

When using the MCP tools with Cursor: 1. The LLM will first check for mcp-config.json in your repository 2. If found, it will use the configured IDs under the clickup section 3. If not found or if you need to use different IDs, you can provide them directly in your requests

To set up your config file: 1. Use the get_workspaces tool to find your workspace ID 2. Use the other navigation tools to find your space and list IDs 3. Create mcp-config.json with your preferred configuration

Usage

You can run the MCP server in two ways:

1. Using Environment Variable (Recommended for Production)

# Set your ClickUp API key as an environment variable
export CLICKUP_API_KEY=your_api_key

# Start the server
clickup-mcp

2. Using Command Line Argument

clickup-mcp your_api_key

Features

• Full ClickUp API integration through MCP
• Task management (create, update, delete)
• Workspace and list navigation
• Natural language task breakdown and analysis
• Checklist management
• Secure API key handling

Available Tools

• get-tasks: Get tasks from a specific list
• get-task: Get details of a specific task
• create-task: Create a new task
• update-task: Update an existing task
• delete-task: Delete a task
• find-task: Find a task by name
• get-subtasks: Get subtasks of a task
• delete-subtasks: Delete all subtasks of a task
• create-checklist: Create a checklist with items
• get-workspaces: Get all workspaces
• get-spaces: Get spaces in a workspace
• get-folders: Get folders in a space
• get-folder-lists: Get lists in a folder
• get-folderless-lists: Get lists not in any folder
• get-all-lists: Get all lists in a space

Prompts

• break-down-task: Get help breaking down a task into manageable subtasks
• analyze-task: Get analysis and insights about a task
• setup-guide: Interactive guide for setting up ClickUp integration

Security

• API keys can be provided via environment variables or command line arguments
• No API keys are stored in the code or configuration files
• Package access is restricted to Meepo organization members

Requirements

• Node.js >= 16
• npm with access to @meepo organization
• ClickUp API key

Support

For internal support, please contact the Meepo development team.

License

UNLICENSED - Proprietary software of Meepo