ClickUp

A Model Context Protocol (MCP) server that enables AI assistants to interact with ClickUp's task management API. This server provides comprehensive task management capabilities through natural language, focusing on essential project workflows rather than ClickUp's full feature set.

Built by theDiversioteam for streamlined AI-powered task management.

# Install from GitHub (latest) uvx --from git+https://github.com/DiversioTeam/clickup-mcp clickup-mcp # Or from PyPI (when published) uvx clickup-mcp

git clone https://github.com/DiversioTeam/clickup-mcp cd clickup-mcp uv sync uv run clickup-mcp

# Set your ClickUp API key uvx clickup-mcp set-api-key YOUR_API_KEY_HERE # Or set environment variable export CLICKUP_MCP_API_KEY=your_api_key

- Log in to ClickUpathttps://app.clickup.com
- Navigate to Settings:

- In the left sidebar, click "Apps"
- Then click "API" (or go directly tohttps://app.clickup.com/settings/apps)

{ "servers": { "clickup": { "command": "uvx", "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"] } } }

macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.jsonLinux:~/.config/claude/claude_desktop_config.json

{ "mcpServers": { "clickup": { "command": "uvx", "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"] } } }

VS Code has excellent MCP support through both native integration and extensions. Multiple setup options available:

Option 1: Native VS Code MCP (Recommended)

VS Code now has built-in MCP support with GitHub Copilot and Agent Mode. Add to your workspace:

Create.vscode/mcp.jsonin your project:

{ "servers": { "clickup": { "command": "uvx", "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"] } } }

- Open Command Palette (Ctrl+Shift+P/Cmd+Shift+P)
- Run "Preferences: Open User Settings (JSON)"
- Add to settings:

{ "mcp": { "servers": { "clickup": { "command": "uvx", "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"] } } } }

Option 2: VS Code Extensions with MCP Support

- create_task- Create new tasks
- get_task- Get task details (supports various ID formats)
- update_task- Update task properties
- delete_task- Delete tasks
- create_task_from_template- Create from predefined templates
- create_task_chain- Create dependent task sequences

- list_tasks- List tasks with filtering options
- search_tasks- Search tasks by text and criteria
- get_subtasks- Get all subtasks of a parent
- get_task_comments- Get comments on tasks
- create_task_comment- Create comments on tasks

- get_task_status- Get current task status
- update_task_status- Change task status
- get_assignees- List task assignees
- assign_task- Assign users to tasks

- list_spaces- List all spaces in workspace
- list_folders- List folders in a space
- list_lists- List all lists
- find_list_by_name- Find lists by name

- bulk_update_tasks- Update multiple tasks at once
- bulk_move_tasks- Move multiple tasks to different lists

- get_time_tracked- Get time tracked for users/periods
- log_time- Log time spent on tasks

- get_team_workload- See task distribution across team members
- get_task_analytics- Get velocity metrics and completion rates

- list_users- List all users in workspace
- get_current_user- Get current authenticated user details
- find_user_by_name- Find users by name or email

"Create a bug report for login issues in the Development list" "Show me all high-priority tasks assigned to me" "Move all completed tasks from Sprint 1 to Archive" "Log 2 hours on task gh-123 for debugging" "What's our team's current workload?" "Create a task chain: Design → Implement → Test → Deploy" "Add a comment to task GH-3761 saying 'testing complete'" "Get all comments on the bug report task" "Comment on task abc123 and assign it to John"

"Create a bug report template for the payment processing issue" "Use the code review template for PR #456" "Create a feature request for dark mode"

"What's our task completion rate this month?" "Who has the most tasks assigned?" "Show me time tracked on the API project"

# Run all tests (62 tests) uv run pytest # Run with coverage uv run pytest --cov=clickup_mcp # Run specific test uv run pytest tests/test_client.py::test_create_task

# Check code style uv run ruff check . # Format code uv run ruff format . # Type checking uv run mypy src/

# Verify API key is configured uv run clickup-mcp check-config # Test API connection uv run clickup-mcp test-connection

# Run with debug logging uv run clickup-mcp --debug

# Add the server for local testing with Claude Code CLI claude mcp add clickup-local -- uv run clickup-mcp # Then you can test the functionality immediately # Example: List spaces, create tasks, add comments, etc.

- Rate Limiting: No built-in rate limiting (ClickUp: 100 req/min)
- Pagination: Limited pagination support
- Caching: No response caching implemented
- Custom Fields: Models exist but limited tool support
- Error Recovery: Basic error handling without sophisticated retry

- Enhanced error handling and retry logic
- Response caching implementation
- Better pagination support
- Expanded custom field support
- Fork the repository
- Create a feature branch (git checkout -b feature/improvement)
- Make changes and add tests
- Ensure all tests pass (uv run pytest)
- Run linting (uv run ruff check .)
- Submit a Pull Request

git clone https://github.com/yourusername/clickup-mcp cd clickup-mcp uv sync uv run pytest # Ensure tests pass

- Issues:GitHub Issues
- Discussions:GitHub Discussions
- Email:tech@diversio.com

MIT License - seeLICENSEfile for details.

- Built byDiversioteam
- Powered byModel Context Protocol
- UsesClickUp API v2

Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem