clickup_whoamiLABSCO SUMMARY
Built around a specific problem: ClickUp's own responses are too big to put in front of a model.
The repository measures it — five tasks come back from the raw API as roughly 12,000 tokens of nested JSON, and the same five render as a compact table at roughly 150. Flattening happens by default and --output json is there when you need everything. The tool filter is the other thing worth setting deliberately: the read and safe profiles are enforced at call time, not just hidden from the tool list, so a filtered destructive call is rejected rather than merely undiscoverable. Note the maintainer's own advice — with 144 tool schemas loading per session, the CLI path costs less context than MCP if your agent can run shell commands.
What it is
A Rust CLI for the ClickUp API with a built-in MCP server, covering every endpoint and returning flattened, compact output built for agents working inside a context window.
What you get
- 144 MCP tools by the README's count, covering 100% of the ClickUp API, all prefixed clickup_
- Tasks: clickup_task_list, clickup_task_search, clickup_task_get, clickup_task_create, clickup_task_update and clickup_task_move
- Comments and docs: clickup_comment_create, clickup_comment_list, clickup_doc_list, clickup_doc_edit_page and clickup_doc_embed_image
- Chat, views, templates, attachments and audit logs, plus clickup_whoami to confirm which account the token belongs to
- Pagination on 15 of the tools, across ClickUp's four different pagination styles, with an all flag to walk the whole set
- Tool filtering at startup — a read or safe profile, or explicit allow and deny lists by group or tool name
- Two binaries with identical behaviour: clickup-cli and the shorter clkup
Requirements
A ClickUp API token, set with the setup command or passed as CLICKUP_TOKEN. Install from npm, Homebrew, crates.io, the AUR, a prebuilt binary for your platform, or run the Docker image with mcp serve. Building from crates.io needs Rust 1.70 or newer.
Setup effort
One command plus a key — npm install -g @nick.bester/clickup-cli, then supply credentials
USE CASES
01
Asking what is on your plate without burning the context window
The task list comes back as a compact table rather than several thousand tokens of nested JSON.
02
Filing work as it comes up in conversation
Create the task in the right list, then update or move it as the plan changes.
03
Letting an agent read ClickUp but not change it
Start the server on the read profile — filtered tools are rejected at call time, not just hidden from the list.
04
Leaving an update where the team will see it
Post the comment on the task instead of summarising it somewhere else.
05
Pulling a whole list rather than the first page
Set the all flag and let the tool walk ClickUp's pagination for you, whichever style that endpoint uses.
144 tools
Listed in project docs. Your client may show a different list.
clickup_auth_checkclickup_workspace_listclickup_workspace_seatsclickup_workspace_planclickup_space_listclickup_space_getclickup_space_createclickup_space_updateclickup_space_deleteclickup_folder_listclickup_folder_getclickup_folder_createclickup_folder_updateclickup_folder_deleteclickup_list_listclickup_list_getclickup_list_createclickup_list_updateclickup_list_deleteclickup_list_add_taskclickup_list_remove_taskclickup_task_listclickup_task_getclickup_task_createclickup_task_updateclickup_task_deleteclickup_task_searchclickup_task_time_in_statusclickup_task_moveclickup_task_set_estimateclickup_task_replace_estimatesclickup_task_add_depclickup_task_remove_depclickup_task_linkclickup_task_unlinkclickup_task_add_tagclickup_task_remove_tagclickup_checklist_createclickup_checklist_updateclickup_checklist_deleteclickup_checklist_add_itemclickup_checklist_update_itemclickup_checklist_delete_itemclickup_comment_listclickup_comment_createclickup_comment_updateclickup_comment_deleteclickup_comment_repliesclickup_comment_replyclickup_tag_listclickup_tag_createclickup_tag_updateclickup_tag_deleteclickup_field_listclickup_field_setclickup_field_unsetclickup_task_type_listclickup_attachment_listclickup_attachment_uploadclickup_time_listclickup_time_getclickup_time_createclickup_time_updateclickup_time_deleteclickup_time_startclickup_time_stopclickup_time_currentclickup_time_tagsclickup_time_add_tagsclickup_time_remove_tagsclickup_time_rename_tagclickup_time_historyclickup_goal_listclickup_goal_getclickup_goal_createclickup_goal_updateclickup_goal_deleteclickup_goal_add_krclickup_goal_update_krclickup_goal_delete_krclickup_view_listclickup_view_getclickup_view_createclickup_view_updateclickup_view_deleteclickup_view_tasksclickup_member_listclickup_user_getclickup_user_inviteclickup_user_updateclickup_user_removeclickup_chat_channel_listclickup_chat_channel_createclickup_chat_channel_getclickup_chat_channel_updateclickup_chat_channel_deleteclickup_chat_channel_followersclickup_chat_channel_membersclickup_chat_dmclickup_chat_message_listclickup_chat_message_sendclickup_chat_message_updateclickup_chat_message_deleteclickup_chat_reaction_listclickup_chat_reaction_addclickup_chat_reaction_removeclickup_chat_reply_listclickup_chat_reply_sendclickup_chat_tagged_usersclickup_doc_listclickup_doc_getclickup_doc_createclickup_doc_pagesclickup_doc_get_pageclickup_doc_add_pageclickup_doc_edit_pageclickup_doc_embed_imageclickup_webhook_listclickup_webhook_createclickup_webhook_updateclickup_webhook_deleteclickup_template_listclickup_template_apply_taskclickup_template_apply_listclickup_template_apply_folderclickup_guest_getclickup_guest_inviteclickup_guest_updateclickup_guest_removeclickup_guest_share_taskclickup_guest_unshare_taskclickup_guest_share_listclickup_guest_unshare_listclickup_guest_share_folderclickup_guest_unshare_folderclickup_group_listclickup_group_createclickup_group_updateclickup_group_deleteclickup_role_listclickup_shared_listclickup_audit_log_queryclickup_acl_updateBEFORE YOU INSTALL
What to know first
Tools you get
144 tools named in the project's documentation.
Requires
- clickup-cli on PATH
- A ClickUp API token, saved with clickup-cli setup or set as CLICKUP_TOKEN
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @nick.bester/clickup-cliMCP Clients
Claude Desktop
CLAUDE DESKTOP · TERMINAL
clickup-cli setup --token <YOUR_TOKEN>Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"clickup": {
"command": "clickup-cli",
"args": [
"mcp",
"serve"
]
}
}
}Cursor
CURSOR · TERMINAL
clickup-cli setup --token <YOUR_TOKEN>Add to your Cursor MCP settings:
CURSOR · JSON
{
"mcpServers": {
"clickup": {
"command": "clickup-cli",
"args": [
"mcp",
"serve"
]
}
}
}
