Glama
Sign In

ClickUp MCP Server

by Nazruden
GitHub
TypeScript
MIT License
5
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables interaction with ClickUp workspaces, providing tools for task management (creating and updating tasks), team and list management (retrieving teams and lists), and board management (creating boards).

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.

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

  1. Quick Start
    1. Installing via Smithery
  2. Environment Variables
    1. Available Tools
      1. Task Management
      2. Team & List Management
      3. Board Management
    2. Development
      1. Security
        1. Troubleshooting
          1. Common Issues
          2. Getting Logs
        2. License

          Related Resources