Labsco
hauptsacheNet logo

ClickUp

★ 45

from hauptsacheNet

Integrate AI assistants with ClickUp for productivity and project management.

🔥🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#automation#payments#database#devops#git#security#translation#project-mgmt

ClickUp MCP for AI Assistants

Model Context Protocol (MCP) server enabling AI assistants to interact with ClickUp workspaces. Get complete task context with comments and images, search across projects, create and update tasks, collaborate through comments, and track time - all through natural language.

This MCP vs Official ClickUp MCP

See also: Official ClickUp MCP Documentation

FeatureThis MCPOfficial ClickUp MCP
SetupLocal npm/npx installRemote MCP (no install)
AuthenticationAPI key onlyOAuth only
Task ContextComplete with comments, status history, inline imagesRequires mutiple tool calls for full contxt
Image SupportInline images with smart size budgetingNot documented
SearchFuzzy search on recent tasks (limited scope)Full ClickUp search database
DocumentsCRUD operationsCRUD + document search
Time TrackingView and create entriesTimers and entries
Chat IntegrationNot supportedSupported
Connected AppsNot supportedConnected Search
Best ForCoding tools, automation, context gatheringChat apps, task management
SupportCommunity (open source)Official ClickUp

Choose this MCP when:

  • You need rich task context with inline images for AI coding tools
  • You need API key authentication for automation or CI/CD pipelines
  • You want the read-minimal mode optimized for development workflows

Choose Official MCP when:

  • You need OAuth authentication for enterprise security compliance
  • You need Chat integration or Connected Search features
  • You want official support and no local installation

What You Can Do

Turn natural language into powerful ClickUp actions:

Agentic Coding & Development:

  • "Look at CU-abc123, can you find the relevant code?"
  • "Can you build the dashboard like described in https://app.clickup.com/t/12a23b45c?"
  • "Check task CU-xyz789 and fix the bugs mentioned in the comments"
  • "Implement the API endpoints described in the integration task"

Time Tracking & Productivity:

  • "Book 2 hours for the client meeting on the XYZ project"
  • "How much time did I spend on development tasks this week?"
  • "Log 30 minutes for code review on the authentication feature"

Smart Search & Discovery:

  • "What task did I mention the CSV import in?"
  • "Find all tasks related to the payment gateway integration"
  • "Show me tasks where users reported login issues"

Daily Workflow Management:

  • "What do I need to do today?"
  • "Create a task for fixing the dashboard bug in the frontend list"
  • "Update the API documentation task to 'in review' status"
  • "What tasks are blocking the mobile app release?"

Rich Context & Collaboration:

  • "Show me all comments on the user authentication task"
  • "What's the latest update on the database migration?"
  • "Add a comment to the design task about the new wireframes"

Document Management:

  • "Find documents about job posting in hauptsache.net space"
  • "Search for API documentation across all spaces"
  • "Read the API documentation in the development space"
  • "Create a new requirements document for the mobile app project"
  • "Update the meeting notes with today's decisions"
  • "What documents are in the product strategy space?"

Key Features

  • Fuzzy matching across task names, descriptions, and comments
  • Multi-language search support for international teams
  • Filter by assignees, projects, status, and metadata

💬 Complete Context

  • Full comment histories and team discussions
  • Task descriptions with embedded images
  • List descriptions and project guidelines
  • Document content with page navigation
  • Access to complete task history and decisions

⏱️ Time Tracking

  • Log time entries with descriptions
  • View historical time logs and entries
  • Query time entries by task or date range

📋 Task & Document Management

  • Create and update tasks with markdown descriptions
  • Create, read, and update documents and pages
  • Add comments and collaborate with team members
  • Manage priorities, due dates, assignees, and tags
  • Handle time estimates and custom field values

🔒 Safety Features

  • Append-Only Descriptions: Description fields are never overwritten - new content is safely appended with timestamps
  • Normal Field Updates: Status, priority, assignees, tags, and dates can be updated normally (easily revertible through ClickUp's history)

MCP Modes & Available Tools

The ClickUp MCP supports three operational modes to balance functionality, security, and performance:

  • 🚀 read-minimal: Perfect for AI coding assistants and context gathering
  • 📖 read: Full read-only access for project exploration and workflow understanding
  • ✏️ write (Default): Complete functionality for task management and productivity workflows
Toolread-minimalreadwriteDescription
getTaskById✅✅✅Get complete task details including comments, images, and metadata
addComment❌❌✅Add comments to tasks for collaboration
updateTask❌❌✅Update tasks (status, priority, assignees, etc.) with SAFE APPEND-ONLY descriptions
createTask❌❌✅Create new tasks with full markdown support
searchTasks✅✅✅Find tasks by content, keywords, assignees, or project context
searchSpaces❌✅✅Browse workspace structure, project organization, and documents
getListInfo❌✅✅Get list details and available statuses for task creation
updateListInfo❌❌✅SAFE APPEND-ONLY updates to list descriptions (preserves existing content)
getTimeEntries❌✅✅View time entries and analyze time spent across projects
createTimeEntry❌❌✅Log time entries for task tracking
readDocument❌✅✅Get document details, page structure, and content with navigation
searchDocuments❌✅✅Search documents by name and space with fuzzy matching and space filtering
updateDocumentPage❌❌✅Update existing page content or name with replace/append modes
createDocumentOrPage❌❌✅Create new documents with first page, or add pages/sub-pages to existing documents

Setting the Mode

Add the mode to your MCP configuration:

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

Markdown Formatting Support

Task descriptions and list documentation support full markdown formatting:

Examples

Task Creation with Markdown:

Create a task called "API Integration" with description:
# API Integration Requirements

## Authentication

- Implement OAuth 2.0 flow
- Add JWT token validation
- **Priority**: High security standards

## Endpoints

1. `/api/users` - User management
2. `/api/data` - Data retrieval
3. `/api/webhook` - Event notifications

## Testing

- [ ] Unit tests for auth flow
- [ ] Integration tests
- [ ] Load testing with 1000+ concurrent users

> **Note**: This replaces the legacy REST implementation

See related task: https://app.clickup.com/t/abc123

Append-Only Updates (Safe): When updating task descriptions, content is safely appended:

[Existing task description content]

---
**Edit (2024-01-15):** Added new acceptance criteria based on client feedback:
- Must support mobile responsive design
- Performance requirement: < 2s load time

This ensures no existing content is ever lost while maintaining a clear audit trail.