clickup_create_page
Create a new page in a ClickUp document by specifying the doc ID, page name, and markdown content. Add subtitles and organize pages hierarchically with parent page IDs.
Instructions
Create a new page in a ClickUp doc
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doc_id | Yes | ClickUp doc ID | |
| name | Yes | Page name | |
| parent_page_id | No | Parent page ID (null for root page) | |
| sub_title | No | Page subtitle | |
| content | Yes | Page content in markdown format |
Implementation Reference
- MCP tool definition for 'clickup_create_page', including name, description, input schema (Zod), and handler function that prepares parameters and delegates to docsService.createPage, returning JSON response.
const createPageTool = defineTool((z) => ({ name: "clickup_create_page", description: "Create a new page in a ClickUp doc", inputSchema: { doc_id: z.string().describe("ClickUp doc ID"), name: z.string().describe("Page name"), parent_page_id: z .string() .optional() .describe("Parent page ID (null for root page)"), sub_title: z.string().optional().describe("Page subtitle"), content: z.string().describe("Page content in markdown format"), }, handler: async (input) => { const pageParams: CreatePageParams = { docId: input.doc_id, name: input.name, parent_page_id: input.parent_page_id, sub_title: input.sub_title, content: input.content, }; const response = await docsService.createPage(pageParams); return { content: [{ type: "text", text: JSON.stringify(response) }], }; }, })); - src/index.ts:29-62 (registration)The createPageTool is included in the 'tools' array which is iterated over to register all tools with the MCP server using server.tool(tool.name, tool.description, tool.inputSchema, tool.handler).
const tools = [ // Task tools getTaskByCustomIdTool, getTaskTool, createTaskTool, updateTaskTool, updateTaskByCustomIdTool, // Space tools getSpacesTool, // Folder tools getFoldersTool, // List tools getListsTool, createListTool, // Custom Field tools getListCustomFieldsTool, setCustomFieldValueTool, setCustomFieldValueByCustomIdTool, // Assignee tools getListAssigneesTool, // Docs tools searchDocsTool, createDocTool, getDocPagesTool, getPageTool, createPageTool, editPageTool, ]; - src/services/docs.service.ts:69-86 (helper)Core implementation of page creation: constructs the request payload and performs POST API call to ClickUp to create the page.
async createPage(params: CreatePageParams): Promise<ClickUpDocPage> { const { docId, name, parent_page_id, sub_title, content } = params; const pageData = { name, parent_page_id: parent_page_id || null, sub_title: sub_title || null, content, content_format: "text/md", }; return this.request<ClickUpDocPage>( `/${this.workspaceId}/docs/${docId}/pages`, { method: "POST", body: JSON.stringify(pageData), } ); } - src/models/types.ts:70-76 (schema)TypeScript interface defining the parameters for creating a ClickUp page, used in the tool handler and service method.
export interface CreatePageParams { docId: string; name: string; parent_page_id?: string; sub_title?: string; content: string; }