ClickUp MCP Server

MIT License

4

Overview InspectNew Schema Related Servers Reviews Score

Need Help?View Source Code Report Issue

ClickUp MCP Server

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

Quick Start

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"
      }
    }
  }
}

Restart Claude for Desktop

That's it! The server will be automatically downloaded and started when needed.

Environment Variables

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

Clone the repository
Install dependencies:

npm install

Start in development mode:

npm run dev

Build for production:

npm run build

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

Authentication Errors
- Verify your OAuth credentials in the environment variables
- Check token expiration
- Ensure proper redirect URI
Rate Limiting
- The server implements automatic rate limit handling
- Check logs for rate limit warnings
- Consider implementing request batching
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 can be found at:

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

License

MIT License - see LICENSE file for details

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

This server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.