Confluence MCP Server

Instructions

Implementation Reference

• src/index.ts:318-335 (handler)

  MCP tool handler for 'create_page': destructures input arguments, calls ConfluenceClient.createPage, and returns the created page as formatted JSON text.

  case 'create_page': {
    const { spaceKey, title, content, parentId } = args as {
      spaceKey: string;
      title: string;
      content: string;
      parentId?: string;
    };
    
    const page = await confluenceClient.createPage(spaceKey, title, content, parentId);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(page, null, 2)
        }
      ]
    };
  }

• src/index.ts:88-113 (registration)

  Registration of the 'create_page' tool in ListToolsRequestHandler, defining name, description, and JSON input schema.

  {
    name: 'create_page',
    description: 'Create a new Confluence page',
    inputSchema: {
      type: 'object',
      properties: {
        spaceKey: {
          type: 'string',
          description: 'Target space key'
        },
        title: {
          type: 'string',
          description: 'Page title'
        },
        content: {
          type: 'string',
          description: 'Page content (HTML or storage format)'
        },
        parentId: {
          type: 'string',
          description: 'Optional: Parent page ID'
        }
      },
      required: ['spaceKey', 'title', 'content']
    }
  },

• src/types.ts:65-74 (schema)

  TypeScript interface defining the Confluence API request body structure for creating a page.

  export interface CreatePageRequest {
    spaceId: string;
    status: string;
    title: string;
    body: {
      representation: string;
      value: string;
    };
    parentId?: string;
  }

• src/confluence-client.ts:214-246 (helper)

  ConfluenceClient.createPage implementation: validates space access, resolves space ID, builds CreatePageRequest, POSTs to /pages API endpoint, returns created page.

  async createPage(
    spaceKey: string, 
    title: string, 
    content: string, 
    parentId?: string
  ): Promise<ConfluencePage> {
    if (!validateSpaceAccess(spaceKey, this.config.allowedSpaces)) {
      throw new Error(`Access denied to space: ${spaceKey}`);
    }
  
    // Get space details to obtain the space ID
    const space = await this.getSpaceByKey(spaceKey);
    if (!space.id) {
      throw new Error(`Unable to get space ID for space: ${spaceKey}`);
    }
  
    const pageData: CreatePageRequest = {
      spaceId: space.id,
      status: 'current',
      title,
      body: {
        representation: 'storage',
        value: content
      }
    };
  
    if (parentId) {
      pageData.parentId = parentId;
    }
  
    const response: AxiosResponse<ConfluencePage> = await this.client.post('/pages', pageData);
    return response.data;
  }