Confluence MCP Server

Instructions

Implementation Reference

• src/index.ts:301-316 (handler)

  MCP tool handler for 'get_page': destructures input arguments, invokes ConfluenceClient.getPage method, serializes the result as JSON, and returns it as text content in the MCP response format.

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

• src/index.ts:69-87 (registration)

  Tool registration in ListToolsResponse: defines name 'get_page', description, and inputSchema specifying required pageId and optional bodyFormat.

  {
    name: 'get_page',
    description: 'Retrieve a specific Confluence page by ID',
    inputSchema: {
      type: 'object',
      properties: {
        pageId: {
          type: 'string',
          description: 'Confluence page ID'
        },
        bodyFormat: {
          type: 'string',
          description: 'Body format to include: "storage" or "view" (optional)',
          enum: ['storage', 'view']
        }
      },
      required: ['pageId']
    }
  },

• src/index.ts:72-86 (schema)

  JSON schema for 'get_page' tool input validation: requires pageId string, optional bodyFormat enum.

  inputSchema: {
    type: 'object',
    properties: {
      pageId: {
        type: 'string',
        description: 'Confluence page ID'
      },
      bodyFormat: {
        type: 'string',
        description: 'Body format to include: "storage" or "view" (optional)',
        enum: ['storage', 'view']
      }
    },
    required: ['pageId']
  }

• src/confluence-client.ts:182-212 (helper)

  ConfluenceClient.getPage helper method: performs authenticated GET to Confluence v1 API content endpoint with space/version/body expansion, validates allowed space access, returns ConfluencePage.

  async getPage(pageId: string, bodyFormat?: string): Promise<ConfluencePage> {
    // Use v1 API for getPage since we need space information anyway
    let expandParam = 'space,version';
    if (bodyFormat) {
      const format = bodyFormat === 'view' ? 'body.view' : 'body.storage';
      expandParam += `,${format}`;
    }
    
    const v1Url = `${this.config.baseUrl}/wiki/rest/api/content/${pageId}?expand=${expandParam}`;
    const auth = Buffer.from(`${this.config.username}:${this.config.apiToken}`).toString('base64');
    
    const response = await axios.get(v1Url, {
      headers: {
        'Authorization': `Basic ${auth}`,
        'Accept': 'application/json',
        'Content-Type': 'application/json'
      },
      timeout: 30000
    });
    
    // Validate space access
    if (!response.data.space || !response.data.space.key) {
      throw new Error('Unable to determine page space for access validation');
    }
    
    if (!validateSpaceAccess(response.data.space.key, this.config.allowedSpaces)) {
      throw new Error(`Access denied to space: ${response.data.space.key}`);
    }
    
    return response.data;
  }