T

clickup-mcp-server

...
Created 2/6/2025byNazruden

Language:

TypeScript

Stars:

5

Forks:

3

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

  1. Clone the repository
  2. Install dependencies:
npm install
  1. Start in development mode:
npm run dev
  1. Build for production:
npm run build
  1. 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 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

  2. 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

Last updated: 3/5/2025

Publisher info

Nazruden's avatar

Nazruden

2
followers
2
following
16
repos

More MCP servers built with TypeScript

docbase-mcp-server

MCP Server Implementation for DocBase

By f4401
aapi-mcp-server

Advanced API MCP Server

By Asphere-xyz1
DBX-MCP-Server

MCP Server for Dropbox

By amgadabdelhafez1