mcp clickup

MCP Server for the ClickUp API, enabling Claude to interact with ClickUp workspaces.

Tools

1. clickup_authenticate
2. Authenticate with ClickUp API using an API token and workspace ID
3. Required inputs:
   • api_token (string): ClickUp API token for authentication
   • workspace_id (string): ClickUp workspace ID for authentication

4. Returns: User information and authentication status

5. clickup_get_task

6. Retrieve a task from ClickUp by task ID
7. Required inputs:
   • api_token (string): ClickUp API token for authentication
   • task_id (string): The ID of the ClickUp task to retrieve

8. Returns: Detailed task information including description, status, and metadata

9. clickup_get_task_by_custom_id

10. Retrieve a task from ClickUp by custom ID
11. Required inputs:
    • api_token (string): ClickUp API token for authentication
    • custom_id (string): The custom ID of the ClickUp task to retrieve
    • workspace_id (string): The workspace ID required for the API request

12. Returns: Detailed task information including description, status, and metadata

13. clickup_get_tasks

14. Retrieve multiple tasks from ClickUp by their IDs
15. Required inputs:
    • api_token (string): ClickUp API token for authentication
    • workspace_id (string): ClickUp workspace ID
    • task_ids (string[]): List of task IDs to retrieve
16. Returns: List of tasks with their complete information

Setup

1. Get your ClickUp API Token:
2. Log in to your ClickUp account
3. Go to Settings → Apps
4. Click "Generate API Token"

5. Copy your API token

6. Get your Workspace ID:

7. Open ClickUp in your browser
8. The Workspace ID is in the URL: https://app.clickup.com/{workspace_id}/home
9. It's a number that starts with a number

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

npx

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickup"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "your-api-token",
        "CLICKUP_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "clickup": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CLICKUP_API_TOKEN",
        "-e",
        "CLICKUP_WORKSPACE_ID",
        "mcp/clickup"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "your-api-token",
        "CLICKUP_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Troubleshooting

If you encounter errors, verify that: 1. Your API token is valid and has not expired 2. The workspace ID is correct 3. You have the necessary permissions in the ClickUp workspace 4. The task IDs you're trying to access exist and are accessible to you

Build

Docker build:

docker build -t mcp/clickup .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.