Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/smeric28/clickup-mcp.git
cd clickup-mcp
npm install
npm run buildRegister it in Claude Code
claude mcp add -e "CLICKUP_CLIENT_ID=${CLICKUP_CLIENT_ID}" -e "CLICKUP_CLIENT_SECRET=${CLICKUP_CLIENT_SECRET}" clickup-mcp -- node /path/to/clickup-mcp/dist/cli.jsReplace any placeholder paths in the command with the real path on your machine.
CLICKUP_CLIENT_IDCLICKUP_CLIENT_SECRETMake your agent remember this setup
clickup-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Full hierarchy management for Spaces, Folders, and Lists
- Comprehensive task operations including creation, updates, and comments
- Integrated time tracking with start/stop timer functionality
- Tagging system for organizing and filtering tasks
- Context-aware inspection of list schemas and custom fields
Tools 5
get_tasksRead tasks from ClickUpcreate_taskCreate a new task in a listcreate_spaceCreate a new space in the workspacestart_timerStart a time tracking sessionget_workspacesList all available workspacesEnvironment Variables
CLICKUP_CLIENT_IDrequiredOAuth Client ID from ClickUp developer portalCLICKUP_CLIENT_SECRETrequiredOAuth Client Secret from ClickUp developer portalTry it
Original README from smeric28/clickup-mcp
ClickUp MCP Server
A robust Model Context Protocol (MCP) server for ClickUp. This server enables AI assistants (like OpenCode, Claude Desktop, etc.) to interact directly with your ClickUp workspace, allowing for natural language management of tasks, lists, folders, and more.
Unlike official adapters that may rely on limited proxies, this implementation connects directly to the ClickUp REST API v2, providing improved reliability and deep integration.
✨ Features
- Full Hierarchy Management: Create, update, and delete Spaces, Folders, and Lists.
- Task Operations: Create tasks, update status/details, fetch comments, and read custom fields.
- Tagging System: Manage tags (create/edit/delete) and apply them to tasks.
- Time Tracking: Start and stop timers, view time entries.
- Context Awareness: Inspect list schemas (statuses, custom fields) and user details.
- Search: (Limited) search for tasks within workspaces.
🚀 Quick Start
Prerequisites
- Node.js v18+
- A ClickUp Account
- A ClickUp OAuth App (Client ID & Secret). Create one here.
Installation
git clone https://github.com/yourusername/clickup-mcp.git
cd clickup-mcp
npm install
npm run build
Configuration & Authentication
Configure Credentials:
node dist/cli.js configure <YOUR_CLIENT_ID> <YOUR_CLIENT_SECRET>Login:
node dist/cli.js loginThis will open your browser to authenticate with ClickUp.
Integration with OpenCode
Run the registration script to add this server to your OpenCode configuration:
powershell -ExecutionPolicy Bypass -File scripts/register.ps1
Restart OpenCode, and the "ClickUp" tools will appear.
🛠️ Available Tools
The server exposes the following tools to the AI:
Task Management
get_tasks/get_task: Read tasks.create_task/update_task: Modify tasks.get_comments/create_comment: Collaborative features.
Hierarchy & Structure (CRUD)
- Workspaces (Teams):
get_workspaces - Spaces:
get_spaces,create_space,update_space,delete_space - Folders:
get_folders,create_folder,update_folder,delete_folder - Lists:
get_lists,create_list_in_folder,create_list_in_space,update_list,delete_list
Schema & Metadata
get_list_details: View list statuses, defaults, and configuration.get_accessible_custom_fields: View available custom fields for a list.get_current_user: Identify the authenticated user.
Tags
get_tags: List available tags.create_tag/edit_tag/delete_tag: Manage the tag library.add_tag_to_task/remove_tag_from_task: Apply tags.
Time Tracking
get_time_entries: View logs.start_timer/stop_timer: Control active sessions.
💻 Development
This project is built with TypeScript and Axios.
- Build:
npm run build - Test:
npm test(Runs comprehensive unit tests with 100% coverage) - Lint:
npm run lint
License
MIT