> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Full project management — tasks, lists, docs, goals, time tracking, chat, and workspace administration

# ClickUp

Shanone's ClickUp integration gives your agent 166 tools covering nearly every corner of ClickUp: tasks, lists, folders, spaces, docs, goals, time tracking, chat, guests, and workspace administration.

## Getting Started

<Steps>
  <Step title="Generate a Personal API Token">
    In ClickUp, go to your **Settings → Apps** page and copy your Personal API Token (starts with `pk_`).
  </Step>

  <Step title="Add it to Shanone">
    Open **Integrations** in the Shanone dashboard, select ClickUp, and paste in the token.
  </Step>

  <Step title="Retry your request">
    Once saved, `shanone_execute_tool` calls for `clickup_*` tools will succeed.
  </Step>
</Steps>

## Available Tools

Shanone provides **166 tools** for ClickUp, organized into these categories:

<AccordionGroup>
  <Accordion title="Tasks (14 tools)">
    `clickup_get_tasks`, `clickup_get_task`, `clickup_create_task`, `clickup_update_task`, `clickup_search_tasks`, `clickup_create_comment`, `clickup_delete_task`, `clickup_move_task`, `clickup_merge_tasks`, `clickup_create_task_from_template`, `clickup_get_task_time_in_status`, `clickup_get_bulk_tasks_time_in_status`, `clickup_update_task_time_estimates`, `clickup_replace_task_time_estimates`
  </Accordion>

  <Accordion title="Lists, Folders & Spaces (14 tools)">
    `clickup_get_list`, `clickup_create_list`, `clickup_get_folderless_lists`, `clickup_create_folderless_list`, `clickup_update_list`, `clickup_delete_list`, `clickup_create_list_from_template`, `clickup_add_task_to_list`, `clickup_remove_task_from_list`, `clickup_get_list_members`, `clickup_get_folder`, `clickup_create_folder`, `clickup_update_folder`, `clickup_delete_folder`
  </Accordion>

  <Accordion title="Workspaces (11 tools)">
    `clickup_get_authorized_user`, `clickup_list_workspaces`, `clickup_list_spaces`, `clickup_list_folders`, `clickup_list_lists`, `clickup_get_workspace_seats`, `clickup_get_workspace_plan`, `clickup_invite_user_to_workspace`, `clickup_get_user`, `clickup_edit_user_on_workspace`, `clickup_remove_user_from_workspace`
  </Accordion>

  <Accordion title="Spaces & Custom Fields (11 tools)">
    `clickup_get_space`, `clickup_create_space`, `clickup_update_space`, `clickup_delete_space`, `clickup_get_custom_task_types`, `clickup_get_list_custom_fields`, `clickup_get_folder_custom_fields`, `clickup_get_space_custom_fields`, `clickup_get_workspace_custom_fields`, `clickup_set_custom_field_value`, `clickup_remove_custom_field_value`
  </Accordion>

  <Accordion title="Time Tracking (13 tools)">
    `clickup_get_time_entries`, `clickup_create_time_entry`, `clickup_get_time_entry`, `clickup_update_time_entry`, `clickup_delete_time_entry`, `clickup_get_time_entry_history`, `clickup_get_running_time_entry`, `clickup_start_time_entry`, `clickup_stop_time_entry`, `clickup_get_time_entry_tags`, `clickup_add_tags_to_time_entries`, `clickup_remove_tags_from_time_entries`, `clickup_change_time_entry_tag_name`
  </Accordion>

  <Accordion title="Views (12 tools)">
    `clickup_get_workspace_views`, `clickup_create_workspace_view`, `clickup_get_space_views`, `clickup_create_space_view`, `clickup_get_folder_views`, `clickup_create_folder_view`, `clickup_get_list_views`, `clickup_create_list_view`, `clickup_get_view`, `clickup_update_view`, `clickup_delete_view`, `clickup_get_view_tasks`
  </Accordion>

  <Accordion title="Chat (20 tools)">
    `clickup_get_chat_channels`, `clickup_create_chat_channel`, `clickup_create_location_chat_channel`, `clickup_create_direct_message`, `clickup_get_chat_channel`, `clickup_update_chat_channel`, `clickup_delete_chat_channel`, `clickup_get_chat_channel_followers`, `clickup_get_chat_channel_members`, `clickup_get_chat_messages`, `clickup_create_chat_message`, `clickup_update_chat_message`, `clickup_delete_chat_message`, `clickup_get_chat_message_reactions`, `clickup_create_chat_reaction`, `clickup_delete_chat_reaction`, `clickup_get_chat_message_replies`, `clickup_create_reply_message`, `clickup_get_chat_message_tagged_users`, `clickup_get_chat_post_subtypes`
  </Accordion>

  <Accordion title="Goals (8 tools)">
    `clickup_get_goals`, `clickup_create_goal`, `clickup_get_goal`, `clickup_update_goal`, `clickup_delete_goal`, `clickup_create_key_result`, `clickup_edit_key_result`, `clickup_delete_key_result`
  </Accordion>

  <Accordion title="Docs (8 tools)">
    `clickup_search_docs`, `clickup_create_doc`, `clickup_get_doc`, `clickup_get_doc_page_listing`, `clickup_get_doc_pages`, `clickup_create_page`, `clickup_get_page`, `clickup_edit_page`
  </Accordion>

  <Accordion title="Comments (9 tools)">
    `clickup_get_task_comments`, `clickup_get_list_comments`, `clickup_create_list_comment`, `clickup_get_chat_view_comments`, `clickup_create_chat_view_comment`, `clickup_update_comment`, `clickup_delete_comment`, `clickup_get_threaded_comments`, `clickup_create_threaded_comment`
  </Accordion>

  <Accordion title="Guests (10 tools)">
    `clickup_invite_guest_to_workspace`, `clickup_get_guest`, `clickup_edit_guest_on_workspace`, `clickup_remove_guest_from_workspace`, `clickup_add_guest_to_task`, `clickup_remove_guest_from_task`, `clickup_add_guest_to_list`, `clickup_remove_guest_from_list`, `clickup_add_guest_to_folder`, `clickup_remove_guest_from_folder`
  </Accordion>

  <Accordion title="Checklists (6 tools)">
    `clickup_create_checklist`, `clickup_update_checklist`, `clickup_delete_checklist`, `clickup_create_checklist_item`, `clickup_update_checklist_item`, `clickup_delete_checklist_item`
  </Accordion>

  <Accordion title="Tags & Dependencies (10 tools)">
    `clickup_get_space_tags`, `clickup_create_space_tag`, `clickup_edit_space_tag`, `clickup_delete_space_tag`, `clickup_add_tag_to_task`, `clickup_remove_tag_from_task`, `clickup_add_dependency`, `clickup_delete_dependency`, `clickup_add_task_link`, `clickup_delete_task_link`
  </Accordion>

  <Accordion title="Templates & Attachments (6 tools)">
    `clickup_get_task_templates`, `clickup_get_list_templates`, `clickup_get_folder_templates`, `clickup_create_task_attachment`, `clickup_get_attachments`, `clickup_create_attachment`
  </Accordion>

  <Accordion title="Members, Groups, Webhooks & Admin (14 tools)">
    `clickup_get_task_members`, `clickup_get_custom_roles`, `clickup_get_shared_hierarchy`, `clickup_get_groups`, `clickup_create_group`, `clickup_update_group`, `clickup_delete_group`, `clickup_get_webhooks`, `clickup_create_webhook`, `clickup_update_webhook`, `clickup_delete_webhook`, `clickup_update_acl`, `clickup_create_audit_logs`
  </Accordion>
</AccordionGroup>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Sprint planning" icon="calendar-check">
    Create tasks from a template, set estimates, and assign them across a list
  </Card>

  <Card title="Time & billing reports" icon="clock">
    Pull time entries by tag or task and summarize billable hours for a client
  </Card>

  <Card title="OKR tracking" icon="target">
    Update goal key results as work progresses and surface goals at risk
  </Card>

  <Card title="Docs-to-tasks workflows" icon="file-text">
    Turn a ClickUp Doc's action items into tracked tasks in the right list
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="clickup_create_task fails with a custom field error">
    Custom field values must be set separately via `clickup_set_custom_field_value` after task creation — `clickup_create_task` doesn't accept arbitrary custom fields directly unless the schema explicitly supports them.
  </Accordion>

  <Accordion title="Chat tools return a 403">
    ClickUp Chat is a newer product surface and may not be enabled on all workspace plans; confirm Chat is active in the ClickUp workspace before calling `clickup_*chat*` tools.
  </Accordion>

  <Accordion title="Can't find the right list_id/folder_id/space_id">
    Walk the hierarchy top-down: `clickup_list_workspaces` → `clickup_list_spaces` → `clickup_list_folders` → `clickup_list_lists`. IDs aren't guessable and must come from these listing calls.
  </Accordion>
</AccordionGroup>