KosmoKrator

productivity

ClickUp MCP Integration for CrewAI

Connect ClickUp to CrewAI through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

34 functions 15 read 19 write API token auth
Submit ClickUp feedback View package source

Connect ClickUp to CrewAI

Expose KosmoKrator integrations to CrewAI workers as scoped local tools.

Wrap kosmo integrations:call for specific tasks or connect workers to a local MCP gateway. The gateway is local, scoped to this integration, and starts with --write=deny so CrewAI can inspect read-capable tools without receiving write access by default.

ClickUp MCP Config for CrewAI

Use per-worker integration scopes to avoid giving every worker every tool.

{
  "mcpServers": {
    "kosmokrator-clickup": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=clickup",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=clickup --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only ClickUp instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

ClickUp Tools Visible to CrewAI

CrewAI sees stable MCP tool names generated from the ClickUp integration catalog.

MCP toolSource functionTypeDescription
integration__clickup__clickup_get_hierarchy clickup.clickup_get_hierarchy Read Get the ClickUp workspace hierarchy — spaces, folders, and lists. Returns a tree structure with IDs and names for navigation. Optionally filter to specific space IDs.
integration__clickup__clickup_search clickup.clickup_search Read Search tasks across the ClickUp workspace. Supports filtering by query, statuses, assignees, and more. Returns matching tasks with their details.
integration__clickup__clickup_list_members clickup.clickup_list_members Read Get all workspace members with their IDs, names, emails, and roles.
integration__clickup__clickup_find_member clickup.clickup_find_member Read Find a workspace member by name or email.
integration__clickup__clickup_resolve_members clickup.clickup_resolve_members Read Convert member names or emails to ClickUp user IDs for assigning tasks.
integration__clickup__clickup_get_tasks clickup.clickup_get_tasks Read Get all tasks in a ClickUp list. Supports filtering by statuses, assignees, and due dates. Use clickup_get_hierarchy first to find the list ID.
integration__clickup__clickup_get_task clickup.clickup_get_task Read Get a single ClickUp task by ID with full details. Supports both regular IDs and custom IDs (e.g., "DEV-42"). Optionally include subtask details.
integration__clickup__clickup_create_task clickup.clickup_create_task Write Create a new task in a ClickUp list. Requires a list ID and task name. Supports description, status, priority, assignees, dates, tags, and creating subtasks via parentTaskId. Use clickup_get_hierarchy to find list IDs.
integration__clickup__clickup_update_task clickup.clickup_update_task Write Update an existing ClickUp task. Supports changing name, description, status, priority, assignees, and dates. Set status to "closed" to complete a task. Supports custom task IDs like "DEV-42".
integration__clickup__clickup_delete_task clickup.clickup_delete_task Write Delete a ClickUp task permanently. Supports custom task IDs like "DEV-42". This action cannot be undone.
integration__clickup__clickup_add_tag clickup.clickup_add_tag Write Add an existing tag to a ClickUp task. The tag must already exist in the space.
integration__clickup__clickup_remove_tag clickup.clickup_remove_tag Write Remove a tag from a ClickUp task.
integration__clickup__clickup_attach_file clickup.clickup_attach_file Write Upload a local file attachment to a ClickUp task. ClickUp's official task attachment endpoint requires multipart file upload; cloud URL passthrough is not supported by this v2 endpoint.
integration__clickup__clickup_read_comments clickup.clickup_read_comments Read Get all comments on a ClickUp task. Supports pagination.
integration__clickup__clickup_add_comment clickup.clickup_add_comment Write Add a new comment to a ClickUp task.
integration__clickup__clickup_current_time_entry clickup.clickup_current_time_entry Read Get the currently running time tracking entry, if any.
integration__clickup__clickup_list_time_entries clickup.clickup_list_time_entries Read Get all time entries for a ClickUp task.
integration__clickup__clickup_start_timer clickup.clickup_start_timer Write Start a time tracking timer on a ClickUp task.
integration__clickup__clickup_stop_timer clickup.clickup_stop_timer Write Stop the currently running time tracking timer.
integration__clickup__clickup_log_time clickup.clickup_log_time Write Add a manual time entry to a ClickUp task.
integration__clickup__clickup_get_list clickup.clickup_get_list Read Get details of a ClickUp list by ID.
integration__clickup__clickup_create_list clickup.clickup_create_list Write Create a new list in a ClickUp space.
integration__clickup__clickup_create_list_in_folder clickup.clickup_create_list_in_folder Write Create a new list in a ClickUp folder.
integration__clickup__clickup_update_list clickup.clickup_update_list Write Update a ClickUp list's name, content, or status.
integration__clickup__clickup_get_folder clickup.clickup_get_folder Read Get details of a ClickUp folder by ID, including its lists.
integration__clickup__clickup_create_folder clickup.clickup_create_folder Write Create a new folder in a ClickUp space.
integration__clickup__clickup_update_folder clickup.clickup_update_folder Write Update a ClickUp folder's name.
integration__clickup__clickup_list_channels clickup.clickup_list_channels Read List all chat channels in the ClickUp workspace.
integration__clickup__clickup_send_message clickup.clickup_send_message Write Send a message to a ClickUp chat channel.
integration__clickup__clickup_manage_document clickup.clickup_manage_document Write Create a ClickUp document in a space, folder, or list. Specify the parent container and visibility (PUBLIC or PRIVATE).

Showing 30 of 34 functions. See the ClickUp MCP reference for the full list.

Related ClickUp Pages

ClickUp CLIUse direct JSON commands instead of MCP discovery. ClickUp MCPFull gateway reference and MCP tool names. KosmoKrator for CrewAIClient-level gateway setup.