ClickUp MCP Server

Quick Start

1. Configure Claude for Desktop:

1. Restart Claude for Desktop

Installing via Smithery

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)

• `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:

1. Start in development mode:

1. Build for production:

1. Run tests:

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 your OAuth credentials in the environment variables - Check token expiration - Ensure proper redirect URI

2. **Rate Limiting** - The server implements automatic rate limit handling - Check logs for rate limit warnings - Consider implementing request batching

3. **Server Not Starting** - Check environment variables are properly set - Verify port 3000 is available - Check Claude for Desktop logs

Getting Logs

• Windows: `%USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log`

• macOS: `~/Library/Logs/Claude/mcp*.log`

License