Nazruden/clickup-mcp-server

A Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.
This server runs via Stdio as per the MCP specification when invoked by an MCP client.
## Quick Start
This server uses your ClickUp Personal API Token for authentication.
1. Generate a Personal API Token: In your ClickUp settings, navigate to "My Settings" > "Apps" and generate a token.
2. Configure your MCP Client (e.g., Claude for Desktop): Set the required environment variable when configuring the server for your client.
Example configuration snippet for an MCP client:
json
"mcpServers": {
"clickup": {
"command": "npx",
"args": ["@nazruden/clickup-server"],
"env": {
"CLICKUPPERSONALTOKEN": "yourpersonalapitokenhere"
3. Restart your MCP Client.
The server will be automatically downloaded and started by the MCP client when needed.
### Installing via Smithery
To install ClickUp MCP Server for Claude Desktop automatically via Smithery:
bash
npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude
## Environment Variables
### Required
CLICKUPPERSONALTOKEN: Your ClickUp Personal API Token. This is essential for the server to authenticate with the ClickUp API.
### Optional
LOGLEVEL: Logging level for the server. Supports error, warn, info, debug. Defaults to info.
ENCRYPTIONKEY: A persistent 32-byte hex-encoded key. The configuration system (src/config/app.config.ts) loads or generates this key, and src/security.ts contains encryption/decryption functions. However, this mechanism is currently not used for encrypting the CLICKUPPERSONALTOKEN within the ClickUpService's Personal API Token authentication flow.
PORT: Server port. This is not used by the default Stdio MCP server mode but might be relevant if an HTTP transport or additional HTTP features (like a separate health check endpoint) were explicitly added. Defaults to 3000 in the config if read.
## Available Tools
The following MCP tools are currently implemented:
### Task Management
clickupcreatetask: Create a new task in a ClickUp list.
Requires: listid, name.
Optional: description, status, priority, assignees, duedate, timeestimate, tags.
clickupupdatetask: Update an existing task's properties.
Requires: taskid.
Optional: Any writable ClickUpTask properties.
### Team & List Management
clickupgetteams: Retrieve all accessible teams (Workspaces in ClickUp API v2).
clickupgetlists: Get all lists in a specific folder.
Requires: folderid.
### Board Management
clickupcreateboard: Create a new board in a ClickUp space.
Requires: spaceid, name.
### Space Management
clickupgetspaces: Retrieves all Spaces for a given Workspace (Team).
Requires: teamid (Workspace ID).
Optional: archived (boolean, defaults to false).
clickupcreatespace: Creates a new Space within a Workspace.
Requires: teamid (Workspace ID), name.
Optional: multipleassignees (boolean), features (object with feature flags like duedates, timetracking, etc.).
clickupgetspace: Retrieves details for a specific Space.
Requires: spaceid.
clickupupdatespace: Updates an existing Space.
Requires: spaceid.
Optional: name, color, private, admincanmanage, archived, features.
clickupdeletespace: Deletes a Space.