mcpField
C
ClickUp MCP Server

ClickUp MCP Server

Local
github.com/nsxdavidProductivity43Updated 80w ago
Repository

About ClickUp MCP Server

ClickUp MCP Server gives AI assistants a standardized interface to access and modify ClickUp workspace data. Its tools cover workspace and task queries, document retrieval, and creating or updating tasks, folders, and lists.

Key features

  1. 01Query workspaces and spaces
  2. 02Retrieve tasks from lists
  3. 03Create and update tasks
  4. 04Fetch workspace documents
  5. 05Create folders and lists

Use cases

  1. 01Let an AI assistant inspect ClickUp tasks
  2. 02Create or update tasks through tools
  3. 03Retrieve documents and organize lists in ClickUp

MCP support

This MCP server exposes tools for MCP clients to query and manage ClickUp data, including workspaces, tasks, docs, folders, and lists.

#clickup#mcp-server#api-integration

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "clickup-mcp-server-nsxdavid": {
      "command": "npx",
      "args": [
        "-y",
        "clickup-mcp-server"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "<CLICKUP_API_TOKEN>"
      }
    }
  }
}
Run commandnpx -y clickup-mcp-server
Environment variables to set
CLICKUP_API_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmclickup-mcp-server

Tools

42

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
workspace_idstringYesThe ID of the workspace to get seats information for

Details

From the project README

ClickUp MCP Server

ClickUp MCP Server Logo

npm version License: MIT Node.js Version MCP SDK

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.