Create a task

Create a task

Creates a task in a List with its name, description, assignees, status, priority, due date and custom fields, and returns the task.

name is the only required field. Statuses differ per List, so read the valid ones before setting one (clickup_get_task with expand_statuses: true). The MCP tool takes assignees as emails, usernames or numeric ids but ignores me: resolve the current user with clickup_resolve_assignees first, and pass workspace_id when the user belongs to more than one Workspace. Custom field values save only when the field applies to the task's custom_item_id.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "clickup": { "url": "https://mcp.clickup.com/mcp" } } }

Call the MCP tool clickup_create_task.

Server URL: https://mcp.clickup.com/mcp

API (official)

• Base URL: https://api.clickup.com/api
• Endpoint: POST /v2/list/{list_id}/task
• Auth: send the header Authorization: $CLICKUP_API_KEY
• Get a key: https://app.clickup.com/settings/apps
• Docs: https://developer.clickup.com/docs/authentication

Before doing anything else, make one read-only call to confirm access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data.
• Never print API keys.