Advertise
MCP.so
Sign In
C

Clickup MCP Server

@hauptsacheNet

Repository

Basic information

Category

Other

Transports

stdio

Author

hauptsacheNet

Submitted by

Marco Pfeiffer

About Clickup MCP Server

Comprehensive reading capabilities for ClickUp

#clickup#read#api

Clickup MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": [
        "-y",
        "@hauptsache.net/clickup-mcp"
      ],
      "env": {
        "CLICKUP_API_KEY": "your_api_key",
        "CLICKUP_TEAM_ID": "your_team_id"
      }
    }
  }
}

Clickup MCP Server tools

3

Get a Clickup task with images and comments by ID

Searches tasks by name, content, assignees, and ID (case insensitive) with fuzzy matching and support for multiple search terms (OR logic). You'll get a rough overview of the tasks that match the search terms, sorted by relevance. Always use getTaskById to get more specific information if a task is relevant.

Lists all open tasks for the current user.

Overview

What is Clickup Mcp?

A Model Context Protocol (MCP) server that enables AI assistants like Claude, Windsurf, and Cursor to interact with your ClickUp tasks. It provides rich task details, full comment history, inline image support, task search, and todo management.

How to use Clickup Mcp?

Configure the MCP server in your AI assistant’s settings by adding the ClickUp MCP entry with the npx command and your CLICKUP_API_KEY and CLICKUP_TEAM_ID environment variables. Once connected, ask your assistant to “Show me details for task CU-123456” or “Find tasks related to login functionality.”

Key features of Clickup Mcp

  • Retrieve complete task information including status, creation date, and assignees
  • Access full comment history for context
  • View inline images in task descriptions and comments
  • Search tasks using keywords
  • List open todos (limited to 50 tasks)
  • Adjustable image limit via MAX_IMAGES environment variable (default 4)

Use cases of Clickup Mcp

  • View detailed task data and comments for a specific ClickUp task
  • Search for tasks related to a topic across your workspace
  • Check your personal todo list of open tasks
  • Get full context (comments + images) for individual tickets

Frequently asked questions

1

What credentials are required?

You need a ClickUp API Key (starts with `pk_`) and your ClickUp Team ID (the ~7-digit number in the URL when in settings). Set them as `CLICKUP_API_KEY` and `CLICKUP_TEAM_ID` environment variables.

2

How can I change the number of images returned per task?

Set the `MAX_IMAGES` environment variable to your desired number. If not set, it defaults to 4. Note that most AI tools have constraints limiting the usable number of images.

3

What is the limit for the todo management feature?

The todo list is limited to 50 tasks to avoid flooding the AI assistant’s context.

4

Does this MCP support ClickUp Lists or Spaces?

No. Browsing Lists or Spaces is not currently supported due to performance issues with large instances.

5

What is language-aware search guidance?

If you set `CLICKUP_PRIMARY_LANGUAGE` (e.g., “de” for German) or the `LANG` environment variable, the `searchTask` tool’s description will recommend providing search terms in both English and that language for better results in multilingual workspaces.

Comments

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise