Skip to main content
The ClickUp integration lets Claudio create and manage initiatives, epics, and user stories in your workspace.

​
Purpose

Use this MCP to:
  • Query workspace hierarchy and tasks
  • Fetch context from initiatives and epics
  • Create user stories with proper context
  • Update task status and details
  • Search for tasks across lists

​
Setup

1

Get your API key

  1. Go to ClickUp Settings → Apps
  2. Generate an API Token
  3. Copy your Team ID from the workspace URL (e.g., https://app.clickup.com/36668236/...)
2

Get your license key

The ClickUp MCP server requires a license key. Contact @taazkareem for access to @taazkareem/clickup-mcp-server.
3

Configure environment variables

Add these variables to your MCP configuration:
"env": {
  "CLICKUP_MCP_LICENSE_KEY": "YOUR_LICENSE_KEY",
  "CLICKUP_API_KEY": "YOUR_API_KEY",
  "CLICKUP_TEAM_ID": "YOUR_TEAM_ID",
  "DOCUMENT_SUPPORT": "true"
}
4

Install the server

The server runs via npx and installs automatically:
"clickup": {
  "command": "npx",
  "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
  "env": { ... }
}

​
Available tools

​
get_workspace_hierarchy

View the structure of your workspace, including spaces, folders, and lists. 
get_workspace_hierarchy()

​
get_workspace_tasks

Search for tasks by list ID. Use this to query initiatives, epics, or user stories. 
get_workspace_tasks(
  list_ids: ["901213053436"],
  include_archived: false
)

​
get_task

Get detailed information about a specific task. 
get_task(taskId: "abc123xyz")

​
create_task

Create a new task in a list. 
create_task(
  listId: "901213056238",
  name: "🎯 Add local testing for Sales Agent",
  markdown_description: "..."
)

​
update_task

Update an existing task’s name, description, status, or other fields. 
update_task(
  taskId: "abc123xyz",
  name: "Updated title",
  status: "in progress"
)

​
Key IDs for P&T - DS & AI Squad

Claudio uses these list IDs to navigate your workspace:

​
Query context

WhatList IDLocation
Initiatives901213053436P&T - General → Approved Initiatives
Current quarter epics901215396098DS & AI Squad → Q1 2026 Epics
Epic backlog901213056240DS & AI Squad → Epics Backlog

​
Create work

WhatList IDLocation
User stories901213056238DS & AI Squad → Sprint Backlog (Upcoming)
Tech debt901213056236DS & AI Squad → Tech Debt & Spikes
The current quarter epics list changes each quarter (Q1 2026, Q2 2026, etc.). Update the list ID when a new quarter starts.

​
Usage examples

​
Create a user story with context

Claudio follows this workflow when you ask to create a user story: 
You: Create a user story for the Sales Agent initiative about local testing

Claudio:
1. Queries initiatives: get_workspace_tasks(list_ids: ["901213053436"])
2. Finds "Sales Agent" initiative
3. Queries related epics: get_workspace_tasks(list_ids: ["901215396098"])
4. Extracts context: OKR, business value, problem, hypothesis
5. Creates story: create_task(listId: "901213056238", ...)
The resulting user story includes:
  • Strategic context from the initiative
  • Problem definition from the epic
  • Business value and success metrics
  • Acceptance criteria based on your prompt

​
Search for tasks

You: Show me all user stories in the sprint backlog

Claudio uses: get_workspace_tasks(list_ids: ["901213056238"])

​
Update task status

You: Move task abc123 to in progress

Claudio uses: update_task(taskId: "abc123", status: "in progress")

​
Best practices

Claudio automatically fetches initiative and epic context before creating user stories. This ensures every story has clear business value and strategic alignment.
Make sure you’re querying the right quarter’s epic list. The list ID changes each quarter (currently Q1 2026 = 901215396098).
Every task should connect to business outcomes. Claudio extracts this from initiative and epic context automatically.
Claudio uses standardized templates for initiatives, epics, and user stories (see docs/integrations/clickup/templates/).

​
Troubleshooting

Verify your CLICKUP_TEAM_ID is correct. You can find it in your workspace URL: https://app.clickup.com/TEAM_ID/...
Make sure your API key has access to the workspace and the specific lists you’re trying to query.
The ClickUp MCP server requires a valid license. Contact the package maintainer if you’re getting license errors.

Build docs developers (and LLMs) love

Get started for freeTalk to us