Clickup

🚀 ClickUp MCP Integration

A Model Context Protocol server that provides seamless integration with ClickUp, allowing large language models to interact with tasks and data in their ClickUp workspaces.

🚀 Quick Start

This MCP server offers a seamless integration with ClickUp, enabling large language models to interact with tasks and data in their ClickUp workspaces.

✨ Features

This MCP server provides the following tools to interact with ClickUp:

Task Management

• clickup_create_task: Create a new task in the ClickUp workspace.
• clickup_get_task: Retrieve detailed information about a specific task using its ID.
• clickup_get_task_by_custom_id: Retrieve task information using a custom ID.
• clickup_update_task: Update an existing task by its ID.
• clickup_update_task_by_custom_id: Update an existing task by its custom ID.
• get_list_tasks: Get all tasks in a list, with optional filtering.

Document Management

• clickup_search_docs: Search for documents within a specific parent.
• clickup_create_doc: Create a new document in ClickUp.
• clickup_get_doc_pages: Get all pages in a ClickUp document.
• clickup_get_page: Get a specific page from a ClickUp document.
• clickup_create_page: Create a new page in a ClickUp document.
• clickup_edit_page: Edit a page in an existing document.

Custom Fields

• clickup_get_list_custom_fields: Get all accessible custom fields in a list.
• clickup_set_custom_field_value: Set the value of a custom field for a task.
• clickup_set_custom_field_value_by_custom_id: Set the value of a custom field using a task's custom ID.

Assignees

• get_list_assignees: Get all members (potential assignees) in a list.

Workspace Structure

• get_spaces: Get workspaces.
• get_space_users: Get users in a workspace.
• get_folders: Get folders.
• get_folder_tasks: Get tasks in a folder.

📦 Installation

To build this project, execute the following commands:

# Install dependencies
npm install

# Run the project
node index.js

📚 Documentation

Configuration

Create a config.json file and add the following content:

{
  "clickup": {
    "token": "your_clickup_api_token",
    "space_id": "your_clickup_space_id"
  }
}

Environment Variables

Set the following environment variables:

• CLICKUP_TOKEN: Your ClickUp API token.
• CLICKUP_SPACE_ID: Your ClickUp workspace ID.

🔧 Troubleshooting

If you encounter issues with the MCP server, follow these troubleshooting steps:

⚠️ Important Note

• Authentication Errors:

• Verify that your API token is correct.
• Ensure that your API token has the necessary permissions to perform the actions.
• Check that your workspace ID is correct.
• Task Access Issues:
  • Confirm that you have access to the task you are trying to retrieve.
  • Verify that the task ID is correct and exists in your workspace.
  • Check if the task might be archived.
• Connection Issues:
  • Ensure that the Docker service is running.
  • Check your network connection.
  • Verify that the environment variables are correctly set in the MCP configuration.

📄 License

This MCP server is distributed under the MIT License. This means you are free to use, modify, and distribute the software under the terms and conditions of the MIT License.