Nazruden Clickup MCP Server

🚀 ClickUp MCP Server

This is an implementation of an MCP protocol server integrated with ClickUp, allowing 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", // Replace with your ClickUp client ID
        "CLICKUP_CLIENT_SECRET": "your_client_secret", // Replace with your ClickUp client secret
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback" // Default redirect URI
      }
    }
  }
}

2. Restart Claude for Desktop.

Done! The server will be automatically downloaded and started when needed.

📦 Installation

Required Environment Variables

• 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 Environment Variables

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

✨ Features

Task Management

• clickup_create_task: Create a new task in a ClickUp list.
• clickup_update_task: Update the attributes of an existing task.

Team and List Management

• clickup_get_teams: Get 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.

💻 Usage Examples

Development

1. Clone the repository:

git clone [Repository URL]

2. Install dependencies:

npm install

3. Start the development mode:

npm run dev

4. Build the production version:

npm run build

5. Run tests:

npm test

🔧 Technical Details

Security

• All tokens are encrypted and stored.
• Secure authentication is implemented using the OAuth2 process.
• Sensitive data is not logged.
• Rate limiting is implemented to prevent API abuse.

📚 Documentation

Frequently Asked Questions

Authentication Errors

• Verify that the OAuth credentials in the environment variables are correctly configured.
• Check the token's expiration date.
• Ensure that the redirect URI matches.

Rate Limiting

• The server has automatic rate limiting handling implemented.
• Check the logs for rate limiting warnings.
• Consider making batch requests to reduce the impact of rate limits.

Server Not Starting

• Check if the environment variables are correctly configured.
• Ensure that port 3000 is available.
• Check the logs of Claude for Desktop.

Getting Logs

The log paths for Claude for Desktop are as follows:

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

📄 License

MIT License - See the LICENSE file for details.