ClickUp MCP Server
A robust Model Context Protocol (MCP) server for ClickUp. This server enables AI assistants (like OpenCode, Claude Desktop, etc.) to interact directly with your ClickUp workspace, allowing for natural language management of tasks, lists, folders, and more.
Unlike official adapters that may rely on limited proxies, this implementation connects directly to the ClickUp REST API v2, providing improved reliability and deep integration.
✨ Features
- Full Hierarchy Management: Create, update, and delete Spaces, Folders, and Lists.
- Task Operations: Create tasks, update status/details, fetch comments, and read custom fields.
- Tagging System: Manage tags (create/edit/delete) and apply them to tasks.
- Time Tracking: Start and stop timers, view time entries.
- Context Awareness: Inspect list schemas (statuses, custom fields) and user details.
- Search: (Limited) search for tasks within workspaces.
🚀 Quick Start
Prerequisites
- Node.js v18+
- A ClickUp Account
- A ClickUp OAuth App (Client ID & Secret). Create one here.
Installation
git clone https://github.com/yourusername/clickup-mcp.git
cd clickup-mcp
npm install
npm run build
Configuration & Authentication
Configure Credentials:
node dist/cli.js configure <YOUR_CLIENT_ID> <YOUR_CLIENT_SECRET>Login:
node dist/cli.js loginThis will open your browser to authenticate with ClickUp.
Integration with OpenCode
Run the registration script to add this server to your OpenCode configuration:
powershell -ExecutionPolicy Bypass -File scripts/register.ps1
Restart OpenCode, and the "ClickUp" tools will appear.
🛠️ Available Tools
The server exposes the following tools to the AI:
Task Management
get_tasks/get_task: Read tasks.create_task/update_task: Modify tasks.get_comments/create_comment: Collaborative features.
Hierarchy & Structure (CRUD)
- Workspaces (Teams):
get_workspaces - Spaces:
get_spaces,create_space,update_space,delete_space - Folders:
get_folders,create_folder,update_folder,delete_folder - Lists:
get_lists,create_list_in_folder,create_list_in_space,update_list,delete_list
Schema & Metadata
get_list_details: View list statuses, defaults, and configuration.get_accessible_custom_fields: View available custom fields for a list.get_current_user: Identify the authenticated user.
Tags
get_tags: List available tags.create_tag/edit_tag/delete_tag: Manage the tag library.add_tag_to_task/remove_tag_from_task: Apply tags.
Time Tracking
get_time_entries: View logs.start_timer/stop_timer: Control active sessions.
💻 Development
This project is built with TypeScript and Axios.
- Build:
npm run build - Test:
npm test(Runs comprehensive unit tests with 100% coverage) - Lint:
npm run lint
License
MIT
Tools 5
get_tasksRead tasks from ClickUpcreate_taskCreate a new task in a listcreate_spaceCreate a new space in the workspacestart_timerStart a time tracking sessionget_workspacesList all available workspacesEnvironment Variables
CLICKUP_CLIENT_IDrequiredOAuth Client ID from ClickUp developer portalCLICKUP_CLIENT_SECRETrequiredOAuth Client Secret from ClickUp developer portal