Skip to main content
Glama
Sign In
enesjakozh

ClickUp MCP Server

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

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

local-only server

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

Tools

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

          Related MCP Servers

          • ClickUp MCP Server

            taazkareem
            A
            security
            A
            license
            A
            quality
            Enables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.
            Last updated -
            18
            203
            89
            TypeScript
            MIT License

          • MCP Server for Asana

            cristip73
            -
            security
            A
            license
            -
            quality
            This server implementation allows AI assistants to interact with Asana's API, enabling users to manage tasks, projects, workspaces, and comments through natural language requests.
            Last updated -
            65
            TypeScript
            MIT License

          • ServiceTitan MCP Server

            JordanDalton
            A
            security
            F
            license
            A
            quality
            An MCP server that allows AI assistants to interact with the ServiceTitan API, requiring client credentials for authentication.
            Last updated -
            454
            TypeScript

          • Remote MCP Server on Cloudflare

            zhouzhou12203
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server implementation that runs on Cloudflare Workers, providing tool integration for AI assistants like Claude with OAuth login capability.
            Last updated -
            16
            TypeScript

          View all related MCP servers

          Appeared in Searches

          ID: 9a7p2exf6u