# clickup-mcp-server

> MCP Server

This repository hosts a Model Context Protocol (MCP) server that integrates ClickUp with AI applications, enabling AI agents to manage ClickUp tasks, spaces, lists, and folders using natural language.

## Overview

- **Category:** Productivity
- **Language:** TypeScript
- **Stars:** 50
- **Forks:** 16
- **Owner:** taazkareem
- **GitHub:** https://github.com/taazkareem/clickup-mcp-server
- **Created:** 2025-02-10T19:51:55+00:00
- **Updated:** 2025-03-28T23:25:45+00:00
- **Source:** https://model-context-protocol.com/servers/clickup-ai-task-management-mcp-server

## Setup

## Setup

1. Get your credentials:
   - ClickUp API key from [ClickUp Settings](https://app.clickup.com/settings/apps)
   - Team ID from your ClickUp workspace URL
2. Choose either hosted installation (sends webhooks) or NPX installation (downloads to local path and installs dependencies)
3. Use natural language to manage your workspace!

## Tools

## Available Tools

1.  Task Management: Create, update, and delete tasks, move tasks, set dates, manage subtasks, add comments and attachments.
2.  Tag Management: Create, update, and delete space tags, add and remove tags from tasks, use natural language color commands.
3.  Workspace Organization: Navigate spaces, folders, and lists, create and manage folders and lists, view workspace hierarchy.
4.  Integration Features: Global name or ID-based lookups, case-insensitive matching, markdown formatting support, built-in rate limiting.
5.  `get_workspace_hierarchy`: Get workspace structure.
6.  `create_task`: Create a task.
7.  `create_bulk_tasks`: Create multiple tasks.
8.  `update_task`: Modify task.
9.  `update_bulk_tasks`: Update multiple tasks.
10. `get_tasks`: Get tasks from list.
11. `get_task`: Get single task details.
12. `get_workspace_tasks`: Get tasks with filtering.
13. `get_task_comments`: Get comments on a task.
14. `create_task_comment`: Add a comment to a task.
15. `attach_task_file`: Attach file to a task.
16. `delete_task`: Remove task.
17. `delete_bulk_tasks`: Remove multiple tasks.
18. `move_task`: Move task.
19. `move_bulk_tasks`: Move multiple tasks.
20. `duplicate_task`: Copy task.
21. `create_list`: Create list in space.
22. `create_folder`: Create folder.
23. `create_list_in_folder`: Create list in folder.
24. `get_folder`: Get folder details.
25. `update_folder`: Update folder properties.
26. `delete_folder`: Delete folder.
27. `get_list`: Get list details.
28. `update_list`: Update list properties.
29. `delete_list`: Delete list.
30. `get_space_tags`: Get space tags.
31. `create_space_tag`: Create tag.
32. `update_space_tag`: Update tag.
33. `delete_space_tag`: Delete tag.
34. `add_tag_to_task`: Add tag to task.
35. `remove_tag_from_task`: Remove tag from task.