Confluence MCP Server

Instructions

Implementation Reference

• src/confluence-client.ts:446-478 (handler)

  Core handler function that executes the page move logic: validates access to source and target spaces, fetches current page, constructs MovePageRequest, and performs PUT /pages/{pageId} to move the page.

  async movePage(
    pageId: string,
    targetSpaceKey: string,
    parentId?: string
  ): Promise<ConfluencePage> {
    const currentPage = await this.getPage(pageId);
    
    if (!currentPage.space || !currentPage.space.key) {
      throw new Error('Unable to determine page space for access validation');
    }
    
    if (!validateSpaceAccess(currentPage.space.key, this.config.allowedSpaces)) {
      throw new Error(`Access denied to source space: ${currentPage.space.key}`);
    }
    
    if (!validateSpaceAccess(targetSpaceKey, this.config.allowedSpaces)) {
      throw new Error(`Access denied to target space: ${targetSpaceKey}`);
    }
  
    const moveData: MovePageRequest = {
      version: { number: currentPage.version.number },
      title: currentPage.title,
      type: 'page',
      space: { key: targetSpaceKey }
    };
  
    if (parentId) {
      moveData.ancestors = [{ id: parentId }];
    }
  
    const response: AxiosResponse<ConfluencePage> = await this.client.put(`/pages/${pageId}`, moveData);
    return response.data;
  }

• src/index.ts:140-161 (schema)

  MCP tool schema registration including name, description, and input schema for move_page.

  {
    name: 'move_page',
    description: 'Move a Confluence page to a different space or parent',
    inputSchema: {
      type: 'object',
      properties: {
        pageId: {
          type: 'string',
          description: 'Page ID to move'
        },
        targetSpaceKey: {
          type: 'string',
          description: 'Target space key to move the page to'
        },
        parentId: {
          type: 'string',
          description: 'Optional: New parent page ID in the target space'
        }
      },
      required: ['pageId', 'targetSpaceKey']
    }
  },

• src/index.ts:356-372 (handler)

  MCP CallToolRequestSchema dispatch handler for move_page: extracts arguments and delegates to ConfluenceClient.movePage, returns JSON response.

  case 'move_page': {
    const { pageId, targetSpaceKey, parentId } = args as {
      pageId: string;
      targetSpaceKey: string;
      parentId?: string;
    };
    
    const page = await confluenceClient.movePage(pageId, targetSpaceKey, parentId);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(page, null, 2)
        }
      ]
    };
  }

• src/types.ts:92-104 (schema)

  TypeScript interface defining the MovePageRequest structure used in the movePage implementation.

  export interface MovePageRequest {
    version: {
      number: number;
    };
    title: string;
    type: string;
    space: {
      key: string;
    };
    ancestors?: Array<{
      id: string;
    }>;
  }