ClickUp MCP Server
About
A Model Context Protocol (MCP) server that provides a standardized interface for AI assistants to interact with the ClickUp API. It enables AI systems to access and manipulate ClickUp data such as workspaces, spaces, folders, lists, tasks, docs, comments, and checklists.
Details
- License
- MIT license
Explore
- Standardized MCP interface for AI assistants
- Access workspaces, spaces, folders, and lists
- Create, read, update, and delete tasks
- Retrieve docs from a workspace
- Create folders and lists
- No authentication besides an API token
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ClickUp MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
git clone https://github.com/nsxdavid/clickup-mcp-server.git
cd clickup-mcp-server
npm install
For users who prefer not to clone the repository, the package can be run directly using npx:
{
"mcpServers": {
"clickup": {
"command": "npx",
"args": [
"-y",
"clickup-mcp-server"
],
"env": {
"CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
},
"disabled": false,
"autoApprove": []
}
}
}
Replace YOUR_API_TOKEN_HERE with your API token
No installation or cloning is required with this method
- Cline VSCode Extension: ~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Claude Desktop Apps:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
npm test
get_workspaces
Get the list of workspaces
get_spaces
Get spaces within a workspace
get_tasks
Get tasks from a list
create_task
Create a new task
update_task
Update an existing task
get_docs_from_workspace
Get all docs from a workspace
create_folder
Create a new folder in a space
get_lists
Get lists in a folder or space
create_list
Create a new list
- get_workspaces: Get the list of workspaces
- get_spaces: Get spaces within a workspace
- get_tasks: Get tasks from a list
- create_task: Create a new task
- update_task: Update an existing task
- get_docs_from_workspace: Get all docs from a workspace
- create_folder: Create a new folder in a space
- get_lists: Get lists in a folder or space
- create_list: Create a new list
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"clickup mcp server": {
"clickup": {
"command": "npx",
"args": [
"-y",
"clickup-mcp-server"
],
"env": {
"CLICKUP_API_TOKEN": ""
}
}
}
}
}McpServers
{
"clickup": {
"command": "npx",
"args": [
"-y",
"clickup-mcp-server"
],
"env": {
"CLICKUP_API_TOKEN": ""
}
}
}<p align="center">
</p>
<p align="center">
<a href="https://www.npmjs.com/package/clickup-mcp-server">
</a>
<a href="https://opensource.org/licenses/MIT">
</a>
<a href="https://nodejs.org/">
<a href="https://github.com/modelcontextprotocol/typescript-sdk">
</p>
A Model Context Protocol (MCP) server that provides a standardized interface for AI assistants to interact with the ClickUp API. This server enables AI systems to access and manipulate ClickUp data such as workspaces, spaces, folders, lists, tasks, docs, comments, and checklists.
Available Tools
- get_workspaces: Get the list of workspaces
- get_spaces: Get spaces within a workspace
- get_tasks: Get tasks from a list
- create_task: Create a new task
- update_task: Update an existing task
- get_docs_from_workspace: Get all docs from a workspace
- create_folder: Create a new folder in a space
- get_lists: Get lists in a folder or space
- create_list: Create a new list
Installation
git clone https://github.com/nsxdavid/clickup-mcp-server.git
cd clickup-mcp-server
npm install
Get ClickUp API Token
1. Log in to ClickUp account
2. Go to Settings > Apps
3. Click "Generate API Token"
4. Copy the token
Configuration
Add to the MCP settings file:
{
"mcpServers": {
"clickup": {
"command": "node",
"args": ["/path/to/clickup-mcp-server/build/index.js"],
"env": {
"CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
},
"disabled": false,
"autoApprove": []
}
}
}
Make sure to correct the path
Make sure to supply your API token
Alternate Installation (npx)
For users who prefer not to clone the repository, the package can be run directly using npx:
{
"mcpServers": {
"clickup": {
"command": "npx",
"args": [
"-y",
"clickup-mcp-server"
],
"env": {
"CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
},
"disabled": false,
"autoApprove": []
}
}
}
Replace YOUR_API_TOKEN_HERE with your API token
No installation or cloning is required with this method
Configuration File Locations
- Cline VSCode Extension: ~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Claude Desktop Apps:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Development
Building
npm run build
Running Tests
npm test
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
