Connect Clickup to AI agents

Connect Clickup to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

get_task

Get Task

Retrieve a single ClickUp task by its ID, including all details such as status, assignees, custom fields, description, dates, tags, and subtasks.

create_folder

Create Folder

Create a new folder in a ClickUp space.

get_spaces

Get Spaces

Retrieve all spaces in the configured ClickUp workspace, including their names, IDs, and statuses.

create_space

Create Space

Create a new space in the configured ClickUp workspace.

delete_list

Delete List

Permanently delete a ClickUp list and all its tasks. This action cannot be undone.

update_task

Update Task

Update an existing ClickUp task. Modify its name, description, status, priority, assignees, dates, time estimate, and more. Also supports adding/removing tags and setting custom field values in a single call.

delete_space

Delete Space

Permanently delete a ClickUp space and all its contents. This action cannot be undone.

create_space_tag

Create Space Tag

Create a new tag in a ClickUp space. Tags can then be applied to tasks.

delete_goal

Delete Goal

Permanently delete a ClickUp goal. This action cannot be undone.

delete_task

Delete Task

Permanently delete a ClickUp task by its ID. This action cannot be undone.

delete_folder

Delete Folder

Permanently delete a ClickUp folder and all its lists. This action cannot be undone.

get_workspace_members

Get Workspace Members

Retrieve all members of the configured ClickUp workspace. Returns user IDs, names, emails, and roles.

update_list

Update List

Update an existing ClickUp list's name, content, due date, or priority.

get_lists

Get Lists

Retrieve ClickUp lists from a folder or space. When a **folderId** is provided, returns lists in that folder. When a **spaceId** is provided, returns folderless lists in the space.

get_workspaces

Get Workspaces

Retrieve all ClickUp workspaces (teams) accessible to the authenticated user. Useful for discovering workspace IDs and understanding account structure.

get_time_entries

Get Time Entries

Retrieve time tracking entries from the workspace. Filter by date range, assignee, or specific task/list/space. Requires the Time Tracking ClickApp to be enabled.

search_tasks

Search Tasks

Search and filter tasks across the entire ClickUp workspace. Filter by status, assignee, tags, due dates, creation dates, and more. Returns paginated results. Use the **listId** parameter to scope to a specific list, or omit it to search across the workspace.

get_task_comments

Get Task Comments

Retrieve all comments on a ClickUp task. Returns the comment text, author, date, and resolution status.

start_timer

Start Timer

Start a running timer in ClickUp. Optionally associate it with a task.

get_custom_fields

Get Custom Fields

Retrieve all custom fields accessible on a ClickUp list. Returns field definitions including their IDs, names, types, and options.

create_goal

Create Goal

Create a new goal (objective) in the ClickUp workspace. Goals track progress through key results.

create_list

Create List

Create a new ClickUp list inside a folder or directly in a space (folderless). Provide either a **folderId** or a **spaceId**.

set_custom_field_value

Set Custom Field Value

Set or update a custom field value on a ClickUp task. The value format depends on the field type (text, number, dropdown, checkbox, date, etc.).

stop_timer

Stop Timer

Stop the currently running timer in the workspace.

create_task_comment

Create Task Comment

Add a comment to a ClickUp task. Supports plain text comments. Optionally assign the comment to a user.

create_time_entry

Create Time Entry

Log a completed time entry in ClickUp. Specify the start time and duration. Optionally associate it with a task.

get_space_tags

Get Space Tags

Retrieve all tags defined in a ClickUp space.

update_space

Update Space

Update an existing ClickUp space's name, color, privacy, or assignee settings.

update_folder

Update Folder

Update the name of a ClickUp folder.

update_goal

Update Goal

Update an existing ClickUp goal's name, description, due date, color, or owners.

get_goals

Get Goals

Retrieve all goals from the workspace. Optionally include completed goals.

create_task

Create Task

Create a new task in a ClickUp list. Supports setting the name, description, status, priority, assignees, dates, time estimates, tags, custom fields, and parent task (for subtasks).

get_folders

Get Folders

Retrieve all folders in a ClickUp space.

create_checklist_item

Create Checklist Item

Create an item inside a ClickUp task checklist.

update_time_entry

Update Time Entry

Update a ClickUp time entry's task, description, start/end time, duration, assignee, tags, or billable flag.

get_running_timer

Get Running Timer

Retrieve the currently running ClickUp timer for the authenticated user or a specified assignee.

update_checklist_item

Update Checklist Item

Update a ClickUp checklist item name, assignee, resolved state, or parent item.

create_checklist

Create Checklist

Create a checklist on a ClickUp task.

update_task_comment

Update Task Comment

Update a ClickUp task comment's text, optional assignee, or resolved state.

delete_task_comment

Delete Task Comment

Delete a ClickUp task comment by its comment ID.

update_space_tag

Update Space Tag

Rename or recolor an existing ClickUp task tag in a Space.

delete_checklist_item

Delete Checklist Item

Delete an item from a ClickUp task checklist.

remove_custom_field_value

Remove Custom Field Value

Remove a ClickUp custom field value from a task without deleting the field definition.

delete_time_entry

Delete Time Entry

Delete a ClickUp time entry from the configured workspace.

update_checklist

Update Checklist

Rename a ClickUp task checklist or change its position on the task.

delete_space_tag

Delete Space Tag

Delete a ClickUp task tag from a Space. This removes the tag definition from the Space.

delete_checklist

Delete Checklist

Delete a checklist from a ClickUp task.

More integrations teams use with Clickup

Slack

Slack: connect with bot OAuth or user OAuth. Send, update, delete, and schedule messages; list and cancel scheduled messages; open DMs and group DMs; manage conversations, members, files, reactions, pins, bookmarks, reminders, user groups, and user status; search messages and files with user scopes; and retrieve user, conversation, and workspace info.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Discord

Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis. Add or remove users, assign roles, kick or ban members, and receive supported message, guild, channel, member, and inbound webhook triggers.

Technical notes for Clickup

Create, update, delete, and search tasks across a hierarchical workspace structure of Spaces, Folders, and Lists. Manage task details including assignees, statuses, priorities, due dates, tags, dependencies, and custom fields. Track time on tasks with timers and time entries. Add comments and attachments to tasks. Create and manage Docs, Views (List, Board, Calendar, Gantt), Goals, and Targets for progress tracking. Organize workspaces by creating and managing Spaces, Folders, and Lists. Retrieve workspace members and team information. Subscribe to webhooks for real-time notifications on task, list, folder, space, and goal events.

Connect Clickup to production AI agents

See how Metorial gives Clickup access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Clickup to AI agents with Metorial.

  1. Can Metorial connect Clickup to AI agents?
    Yes. Metorial connects AI agents to Clickup through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.