ClickUp MCP Server

Instructions

Implementation Reference

• src/index.ts:170-201 (handler)

  The asynchronous handler function that implements the create_task tool. It constructs task data from arguments and posts it to the ClickUp API to create a new task, returning the response or an error.

  const createTask = async (args: any) => {
    try {
      const taskData: any = {
        name: args.name,
      };
      if (args.description) taskData.description = args.description;
      if (args.assignees) taskData.assignees = args.assignees;
      if (args.due_date) taskData.due_date = parseInt(args.due_date);
      const response = await clickupApi.post(`/list/${args.list_id}/task`, taskData);
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response.data, null, 2),
          },
        ],
      };
    } catch (error) {
      if (axios.isAxiosError(error)) {
        return {
          content: [
            {
              type: "text",
              text: `ClickUp API error: ${error.response?.data?.err ?? error.message}`,
            },
          ],
          isError: true,
        };
      }
      throw error;
    }
  };

• src/index.ts:48-77 (schema)

  The input schema and description for the create_task tool, defined within the server's capabilities.

  create_task: {
    description: "Create a new task in a ClickUp list",
    inputSchema: {
      type: "object",
      properties: {
        list_id: {
          type: "string",
          description: "ClickUp List ID"
        },
        name: {
          type: "string",
          description: "Task name"
        },
        description: {
          type: "string",
          description: "Task description"
        },
        assignees: {
          type: "array",
          items: { type: "number" },
          description: "Array of assignee user IDs"
        },
        due_date: {
          type: "string",
          description: "Due date in Unix timestamp (milliseconds)"
        }
      },
      required: ["list_id", "name"]
    }
  },

• src/index.ts:279-294 (registration)

  The CallToolRequestHandler registration where the create_task tool is dispatched by calling the createTask handler function based on the tool name.

  server.setRequestHandler(CallToolRequestSchema, async (request) => {
    // @ts-ignore
    const { name, arguments: args } = request.params;
    switch (name) {
      case 'get_tasks':
        return await getTasks(args);
      case 'create_task':
        return await createTask(args);
      case 'update_task':
        return await updateTask(args);
      case 'get_task':
        return await getTask(args);
      default:
        throw new Error(`Unknown tool: ${name}`);
    }
  });