ClickUp MCP Server

Instructions

Implementation Reference

• src/index.ts:236-261 (handler)

  The main handler function for the 'get_task' tool. It makes a GET request to the ClickUp API using the provided task_id and returns the task details as JSON or an error message.

  const getTask = async (args: any) => {
    try {
      const response = await clickupApi.get(`/task/${args.task_id}`);
      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:112-124 (schema)

  The schema definition for the 'get_task' tool, including description and inputSchema requiring 'task_id'.

  get_task: {
    description: "Get details of a ClickUp task",
    inputSchema: {
      type: "object",
      properties: {
        task_id: {
          type: "string",
          description: "ClickUp Task ID"
        }
      },
      required: ["task_id"]
    }
  }

• src/index.ts:289-290 (registration)

  Registration of the 'get_task' tool in the CallToolRequestHandler switch statement, dispatching to the getTask handler.

  case 'get_task':
    return await getTask(args);