# ClickUp MCP Server Premium - Installation Guide
Thank you for supporting the ClickUp MCP Server! Setup is simple - just add your license key to your MCP configuration.
## Quick Start (3 Steps)
### Step 1: Purchase a License
### 1. Get Your License Key
Purchase a license at:
* **[Monthly Subscription ($9/mo)](https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW)**
* **[Lifetime Access ($59)](https://buy.polar.sh/polar_cl_whcMn4lbBFwZUoWU5p2qDSn0fs23ACC6IwK3e15hXV5)**
After purchase, you'll receive a license key that looks like: `CKUP_XXXXX-XXXXX-XXXXX-XXXXX`
### Step 2: Add to Your MCP Configuration
Add this to your Claude Desktop (or other MCP client) configuration:
```json
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_MCP_LICENSE_KEY": "your-license-key-here",
"CLICKUP_API_KEY": "your-clickup-api-key",
"CLICKUP_TEAM_ID": "your-team-id",
"DOCUMENT_SUPPORT": "true"
}
}
}
}
```
### Step 3: Get Your ClickUp Credentials
1. **API Key**: Go to [ClickUp Settings → Apps](https://app.clickup.com/settings/apps)
2. **Team ID**: The first UUID in your ClickUp workspace URL
- Example: In `https://app.clickup.com/[TEAM_ID]/v/l/[PROJECT_ID]`, use the `TEAM_ID` portion
- This is your Workspace ID (ClickUp's API refers to workspaces as "teams" for legacy reasons)
### Step 4: Restart Your MCP Client
Restart Claude Desktop (or your MCP client) and you're ready to go!
Test with: *"Get my ClickUp workspace hierarchy"*
---
## Configuration Options
| Environment Variable | Required | Description |
|---------------------|----------|-------------|
| `CLICKUP_MCP_LICENSE_KEY` | ✅ Yes | Your license key from Polar.sh |
| `CLICKUP_API_KEY` | ✅ Yes | Your ClickUp API key |
| `CLICKUP_TEAM_ID` | ✅ Yes | Your ClickUp team/workspace ID |
| `DOCUMENT_SUPPORT` | Optional | Enable document features (`"true"` or `"false"`) |
## Troubleshooting
### "License Key Required" Error
Make sure you've added `CLICKUP_MCP_LICENSE_KEY` to your env configuration with the key you received after purchase.
### "Invalid License Key" Error
1. Check that you copied the entire license key correctly
2. Make sure there are no extra spaces
3. If the issue persists, contact support
### Server Not Starting
1. Ensure Node.js v18+ is installed: `node --version`
2. Check all required environment variables are set
3. Try clearing the npx cache: `npx clear-npx-cache`
## Updating to Latest Version
The `@latest` tag automatically uses the newest version. To force an update:
```bash
npx clear-npx-cache
```
Then restart your MCP client.
## Support
As a premium user, you have priority support:
- **Open an issue**: [GitHub Issues](https://github.com/TaazKareem/clickup-mcp-server/issues)
- **Email**: taazkareem@icloud.com
Thank you for your support! 🙏
