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

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K
Advertise