📌Overview

Purpose: To provide a Model Context Protocol server implementation for seamless integration of AI assistants with ClickUp workspaces.

Overview: The ClickUp MCP Server enables enhanced interactions within ClickUp by allowing AI assistants to create, update, and manage tasks effectively. It is designed for easy integration and secure operation, suitable for developers and organizations seeking to optimize their workflow processes.

Key Features:

• Task Management: Allows users to create and update tasks within ClickUp, facilitating efficient task handling and project management.

• Team & List Management: Provides functionalities to retrieve accessible teams and lists within specific folders, streamlining organization and collaboration.

• Board Management: Offers the capability to create new boards within ClickUp spaces, assisting in visual project planning and management.

---

ClickUp MCP Server

A Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.

Quick Start

1. Configure Claude for Desktop:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id",
        "CLICKUP_CLIENT_SECRET": "your_client_secret",
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

2. Restart Claude for Desktop.

The server will be automatically downloaded and started when needed.

Installing via Smithery

To install ClickUp MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

Environment Variables

Required:

• CLICKUP_CLIENT_ID: Your ClickUp OAuth client ID
• CLICKUP_CLIENT_SECRET: Your ClickUp OAuth client secret
• CLICKUP_REDIRECT_URI: OAuth redirect URI (default: http://localhost:3000/oauth/callback)

Optional:

• PORT: Server port (default: 3000)
• LOG_LEVEL: Logging level (default: info)

Available Tools

Task Management

• clickup_create_task: Create a new task in a ClickUp list
• clickup_update_task: Update an existing task's properties

Team & List Management

• clickup_get_teams: Retrieve all accessible teams
• clickup_get_lists: Get all lists in a specific folder

Board Management

• clickup_create_board: Create a new board in a ClickUp space

Development

1. Clone the repository
2. Install dependencies:

npm install

3. Start in development mode:

npm run dev

4. Build for production:

npm run build

5. Run tests:

npm test

Security

• All tokens are encrypted at rest
• OAuth2 flow for secure authentication
• No sensitive data logged
• Rate limiting to prevent API abuse

Troubleshooting

Common Issues

1. Authentication Errors

   • Verify OAuth credentials in environment variables
   • Check token expiration
   • Ensure proper redirect URI

2. Rate Limiting

   • Server implements automatic rate limit handling
   • Check logs for rate limit warnings
   • Consider request batching

3. Server Not Starting

   • Check environment variables are properly set
   • Verify port 3000 is available
   • Check Claude for Desktop logs

Getting Logs

Claude for Desktop logs location:

• Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
• macOS: ~/Library/Logs/Claude/mcp*.log

License

MIT License - see LICENSE file for details