Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Confluence MCP & page macros

Georg Duemlein
July 21, 2025

I am trying the Atlassian MCP with Claude and it unlocks powerful workflows.

However, when the MCP fetches and updates pages, it loses macros like page properties, layouts, and the table of contents.

There is a third-party mcp (https://github.com/sooperset/mcp-atlassian/blob/main/src/mcp_atlassian/confluence/pages.py) that has options to skip the conversion of pages to markdown. 

Am I missing some setting or prompt technique?

1 answer

1 accepted

0 votes
Answer accepted
Vishalakshi Narayana Swamy
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
July 23, 2025

Hi @Georg Duemlein

Welcome to Atlassian community!

From the problem summary, I understand that you have queries related to the MCP server configuration and integration.

I would like to inform you that we have a dedicated MCP team to assist you with the same, I suggest you to raise a support request directly with the MCP team here: https://customerfeedback.atlassian.net/servicedesk/customer/portal/1701/group/1762/create/11360.

Hope this helps!

Best Regards,

Vishalakshi Narayanaswamy

 

Lucas Sanchez
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
December 17, 2025

hi @Vishalakshi Narayana Swamy

Is there a new page where i can resolve these answered?

im also traying to use mcp and macros.

 

Greatings

Vishalakshi Narayana Swamy
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
December 17, 2025

Hi @Lucas Sanchez ,

Thank you very much for writing back to us.

Can you please specify more in detail on what page your are looking forward to so that I can assist you better?

Best Regards,

Vishalakshi Narayanaswamy

Lucas Sanchez
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
December 18, 2025

hi @Vishalakshi Narayana Swamy 

I'm looking to update existing pages in my space. I need to add a details macro to each page.

 

<ac:structured-macro ac:name="details" ac:schema-version="1" data-layout="default">
<ac:parameter ac:name="hidden">true</ac:parameter>
...

 

I realized that Atlassian MCP requires the ADF format.

 

{"error":true,"message":"Invalid ADF content provided. Failed to parse: Unexpected token '<', "<ac:struct"... is not valid JSON"}

 

I also tried using an automation rule, but I couldn't find a way to add the macro.

Finally, I'm using the REST API. I created a token and, using curl, updated my pages.

 

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events