ClickUp MCP Integration

Instructions

Implementation Reference

• src/controllers/docs.controller.ts:140-170 (handler)

  Full tool definition for 'clickup_edit_page', including Zod input schema, description, and handler function that prepares parameters and calls the docsService.editPage method.
  const editPageTool = defineTool((z) => ({ name: "clickup_edit_page", description: "Edit a page in a ClickUp doc", inputSchema: { doc_id: z.string().describe("ClickUp doc ID"), page_id: z.string().describe("ClickUp page ID"), name: z.string().optional().describe("Page name"), sub_title: z.string().optional().describe("Page subtitle"), content: z.string().optional().describe("Page content in markdown format"), content_edit_mode: z .string() .optional() .describe( "Content edit mode (replace, append, prepend), default is replace" ), }, handler: async (input) => { const pageParams: EditPageParams = { docId: input.doc_id, pageId: input.page_id, name: input.name, sub_title: input.sub_title, content: input.content, content_edit_mode: input.content_edit_mode, }; const response = await docsService.editPage(pageParams); return { content: [{ type: "text", text: JSON.stringify(response) }], }; }, }));
• src/services/docs.service.ts:88-106 (helper)

  Helper method in DocsService that performs the actual API call to edit a ClickUp doc page using PUT request with prepared payload.
  async editPage(params: EditPageParams): Promise<ClickUpDocPage> { const { docId, pageId, name, sub_title, content, content_edit_mode } = params; const pageData = { name, sub_title, content, content_edit_mode: content_edit_mode || "replace", content_format: "text/md", }; return this.request<ClickUpDocPage>( `/${this.workspaceId}/docs/${docId}/pages/${pageId}`, { method: "PUT", body: JSON.stringify(pageData), } ); }
• src/index.ts:89-91 (registration)

  Registers all imported tools, including clickup_edit_page, into the MCP server by iterating over the tools array and calling server.tool().
  tools.forEach((tool) => { server.tool(tool.name, tool.description, tool.inputSchema, tool.handler); });
• src/index.ts:17-17 (registration)

  Imports the clickup_edit_page tool from docs.controller.ts
  editPageTool,
• src/models/types.ts:78-85 (schema)

  TypeScript interface defining the parameters for editing a page, used in the service and controller.
  export interface EditPageParams { docId: string; pageId: string; name?: string; sub_title?: string; content?: string; content_edit_mode?: string; }