Claude for Confluence: how to connect it, and what it can't do

What actually connects Claude to Confluence?

There's no Confluence-specific Claude integration. There's one Atlassian connector, and Confluence rides inside it.

The thing doing the work is the Atlassian MCP server, launched as the Atlassian Remote MCP Server and later called the Rovo MCP server. It's a cloud-hosted bridge at https://mcp.atlassian.com/v2/mcp that speaks the Model Context Protocol, the open standard Anthropic created for wiring AI clients to outside systems. Atlassian describes it as a proxy rather than a product, and states plainly that it "does not store or cache your Jira or Confluence content."

The v1 endpoints (/v1/mcp and /v1/mcp/authv2) still work, but Atlassian says any v1 use will automatically start exposing v2 tools on 1 March 2027. If you set it up in the summer, plan the move now.

Two facts about it surprise most people.

The first is the price. Connecting costs nothing; Atlassian's page says "Start for free. No credit card required." What v2 added is a meter on some calls. Atlassian lists enriched Teamwork Graph calls, such as the Rovo search tool and getTeamworkGraphContext, as MCP calls that draw Rovo credits, "1-10 Rovo credits per call" for the vast majority. Those credits come from the same org pool as Rovo Chat. Throughput is a separate question. Atlassian's v1-era figures were 500 calls per hour on Free, 1,000 on Standard, and 1,000 plus 20 per user up to 10,000 on Premium and Enterprise, site-level and shared with Jira. I couldn't find a v2 page that restates them, so treat those as a guide.

The second is that auth got simpler. In v1, each product had its own rule. In v2, almost every permission group accepts OAuth 2.1 and API token auth.

When I first wrote up Claude for Jira Service Management, the punchline was that a normal OAuth login surfaced zero JSM tools. That changed on 20 October 2026, when Atlassian added twelve JSM tools to v2 (search, get, create and transition requests, among others) and moved JSM onto OAuth too. Confluence was always the easy case. Click through the consent screen and you have the full set your admin allows.

One catch that trips up custom clients: getAccessibleAtlassianResources is a required first call for any tool, because every call needs a cloudId. Atlassian's docs say so in those words. On a multi-site org it's also where the agent quietly decides which Confluence it's about to write to.

And it's Cloud only, with no Data Center path at all. That's structural rather than a roadmap gap, since a self-managed instance has no cloudId to hand over. The GitHub request for it has been open since November 2025.

What can Claude do in Confluence? The v2 tools

Atlassian publishes 65 Confluence tools across three permission groups: 25 read, 39 write, one search. Admins grant them in whole groups, never individually. Only four are "primary" and show up in Claude's tool list straight away: getConfluenceContent, createConfluenceContent, updateConfluenceContent and searchConfluence. Claude finds the rest through a discover tool and runs them through executeRead, executeWrite or executeDestructive.

Rather than list them, here's what they mean for the nine things people actually ask Claude to do with a wiki.

v1 had real gaps here. No attachments, no labels, no page history, no move or copy, no templates. v2 closed nearly all of them. What's still missing is a hard delete for Confluence content (archive only) and a dedicated parent or child lookup. Atlassian's supported tools reference is the page that enumerates them. If a gap here is a blocker, the marketplace route is usually next: I've rounded up the better options in top Confluence apps and Confluence AI apps.

How to connect Claude to Confluence

Setup is quick. The order matters more than the commands, because the admin consent step is what stalls most first attempts.

1. Get a site admin ready. The Atlassian MCP server isn't a Marketplace app you install ahead of time. It installs just-in-time the first time someone completes the OAuth consent flow, and a site admin has to approve that first consent. If you're not an admin, ask before you start rather than after you hit the wall.

2. Add the connector on your surface. In Claude Code it's one line:

claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp

Then run /mcp inside a session to authenticate. For a project-scoped setup, the repo's own .mcp.json is the equivalent:

{
  "mcpServers": {
    "atlassian": {
      "type": "http",
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

In Claude Desktop it's Settings, then Extensions, then Browse extensions, then Plugins, then search for Atlassian. On claude.ai there's no JSON at all: you add the Atlassian listing from the connectors directory, which is a first-party listing built by Atlassian rather than a community project. If you installed the v1 connector, Atlassian says it becomes a "Custom Web" connector; remove it and reinstall from the directory. v2 is a separate OAuth resource, so you sign in again either way.

3. Decide the permission groups before you consent, not after. Admins control access at the group level through the permissions tab, where each shows as Allowed, Blocked, or Partially allowed. If you only want reading, block write_confluence now. Restoring an earlier page version is a tool in v2, but it's better not to need it. Since 29 September 2026 admins can also set an Atlassian MCP rule in Data Security Policies, scoped by app, space and classification level.

4. Check the network path if Confluence sits behind anything. Claude reaches the MCP server from Anthropic's cloud, not from your laptop, on every client including Desktop. A firewalled setup needs Anthropic's IP ranges allowlisted. Atlassian's built-in list of AI partner domains is still one switch: you can't block ChatGPT from it and keep Claude. What you can do is switch the list off and add the domains you trust yourself.

5. Name the connector in your prompts. This one only shows up in practice, and a Reddit user put it well.

"I have had quite a bit of luck using it with JIRA and Confluence to read docs/tickets as well as generate them. I am using it mostly through Claude Code and Claude Desktop on Mac. I find if I'm not super explicit that I want it to use the MCP it will go haywire."

ChezTheHero, r/ClaudeAI, Reddit

What is the connection actually good at?

Retrieval. That's the honest answer, and it's a bigger deal than it sounds, because native Confluence search has a reputation.

The strongest endorsement I found came from a developer comparing MCP search against Confluence's own:

"Considering how poor the Confluence search function is, the results from Confluence via an MCP-powered search are remarkably good. I was able to solve one or two obscure, company-specific issues purely by using the MCP search, and I'm convinced that finding these pages would have been almost impossible without it."

icanintospace, Hacker News

That maps to what the tools are shaped for. A model that can call searchConfluence, read the hits, then pull the full pages with getConfluenceContent is doing something Confluence's search box structurally cannot. If you'd rather build that loop yourself, the Confluence AI API guide covers the direct route.

The connector also ships six bundled agent skills, now written for v2, four of which touch Confluence: Search Company Knowledge runs parallel cited searches, Spec to Backlog turns a Confluence spec into Jira epics and tickets, Generate Status Reports pulls Jira issues into a published Confluence page, and Capture Tasks from Meeting Notes does what it says. If you already run Atlassian AI project management, Spec to Backlog is the one worth trying first, and the Jira half of it overlaps heavily with what a Jira copilot does. The status-report skill is the closest thing here to real Confluence workflow automation.

Worth knowing about the repo itself: atlassian/atlassian-mcp-server holds no server source at all. It's the README, manifests, plugins for Claude Code and other clients, and those skills. The server is closed-source and cloud-hosted. It carries 1,124 stars, an Apache-2.0 licence, and 91 open issues, 34 of them mentioning Confluence.

Where it breaks: writing to Confluence

Reading is solid. Writing is where I'd still slow down, though v2 fixed the worst of it, and the v1 evidence is unusually specific.

In May 2026, a user posted a data-loss report to the Atlassian Community that is the sharpest artefact in this whole topic:

"I used Claude via the Atlassian Rovo MCP connector to rename and reorganize pages in my Confluence workspace. Claude sent update calls that changed the title but did not include the body field. The Confluence API interpreted the missing body as an instruction to clear the page content. Every page that was renamed had its entire body silently deleted."

Ryan Wilson, Atlassian Community

The same post notes that a call reducing a page from 15,000 characters to zero executes with no warning or confirmation prompt. That was the v1 tool, updateConfluencePage.

Credit where it's due: Atlassian did not stonewall this. A developer on the Confluence MCP team replied the next day saying the team would fix it, and by July 2026 followed up that "on the V2 MCP preview just released, we've completely rewritten how Confluence page edits work to use targeted granular edits." v2 is now the documented endpoint. Its updateConfluenceContent does full-body replacement or granular edits, and a document edit needs a snapshot token from the read before it. If you're on v2, the specific defect is addressed. If you're still on v1, it isn't.

The v1 issue trail is still worth a look if you haven't moved. updateConfluencePage wanted the complete page body on every edit, with no patch or range option. Issue #106 documents what that costs at scale: ADF bodies reach 50 to 70KB, the model has to hold the whole thing and re-emit it inside a tool call, and Claude Code persists tool outputs over roughly 20KB to disk, so the content never reaches working context. Related reports cover stripped inline comment anchors (now closed), removed images and tables of contents, and a roughly 5KB write ceiling on the Claude connector caused by a Cloudflare rule at Anthropic's edge. That last one is still open, and it sits outside Atlassian's server, so v2 alone doesn't settle it.

Then there's the friction that has nothing to do with Confluence and everything to do with staying signed in. The Atlassian Community thread on it has over 16,500 views.

"Atlassian MCP is unusable due to the longevity of their auth tokens. Needing to reauthenticate twice a working day is horrible. Why can;t I inject my personal access token into it; that is longlived and properly in control."

Jochem Berends, Atlassian Community

Another user in the same thread reports re-authenticating roughly every 30 minutes. It's the most-cited operational complaint about the server, and it's the reason a small cottage industry of hand-rolled Atlassian MCP servers exists. API token auth, now open to every major group in v2, is Atlassian's answer for non-interactive use.

The permission ceiling nobody checks first

Here's the reassuring part, followed by the part that costs people a week.

Access is scoped to the signed-in user's existing Confluence permissions. Atlassian's docs say access "is scoped to the user's existing permissions in Atlassian." A restricted space stays invisible. listConfluenceSpaces returns only the spaces that account can already open. The MCP server grants no elevation whatsoever.

The cost of that guarantee is that your answer quality is capped by the account you connected, not by what's in Confluence. This is the single most common false alarm I see in the eesel support queue, and it looks nothing like a permissions problem from the outside. A customer connects Confluence, then asks a question their pages obviously answer and gets nothing back. Every dashboard says the connection is fine, because it is. The pages were scoped away by permissions the whole time. I've watched eesel's own agent misdiagnose that exact state as a broken integration, which is worse than useless, because the customer then goes and re-authorises an integration that was never broken.

Three years of putting AI on live support queues has taught me to check this before anything else. When retrieval looks mysteriously empty, the question is never "is the connector working." It's "what can the connected account actually see."

Two related points for whoever runs your security review. Space scoping used to be missing, and it's still the most-discussed repo issue at 25 comments. Atlassian's answer, since 29 September 2026, is the MCP control in Data Security Policies, which sets org-wide defaults with overrides by app, space and classification. Without one, an admin who connects their own account hands the agent an admin's reach across every space they can edit. And Atlassian is explicit that Rovo MCP is excluded from its HIPAA coverage, along with the CLI, the Chrome extension, and the mobile and desktop apps, even though Rovo Chat, Agents, and Search are in scope. There's no FedRAMP support either.

Why is your Confluence the bottleneck, not Claude?

Because the model can only be as right as the pages it reads. This is the part most guides skip, and it's the one that decides whether the rollout lands.

Across Hacker News, Reddit, and G2, the same finding keeps arriving independently from people who have no reason to agree with each other. The clearest single sentence came from a thread about AI and engineering work:

"How can AI search into documentation, if the documentation is a thousands of obsolete and contradicting Jira tickets, few outdated Confluence pages with mail attachments and handful of excel files on SharePoint?"

ponector, Hacker News

An engineering manager put a number on it that I keep coming back to:

"we had a confluence wiki with 400+ pages. nobody read it. nobody updated it. new hires were told 'the wiki has everything' and then spent a week being confused because the wiki was 60% outdated."

r/Notion, replacing a Confluence wiki

What makes this more than grumbling is where the same point shows up next. On G2's Rovo listing, which sits at 4.7 out of 5 across only six reviews, the criticism comes from satisfied reviewers. An enterprise SDET who scored it 4 out of 5 wrote that "the biggest limitation is that Rovo can only be as effective as the underlying data. If documentation is outdated, inconsistent, or incomplete, the search results and AI-generated insights may not always be as accurate or useful as expected." A cloud BI engineer, different month and different industry, landed in the same place independently.

The failure mode that matters isn't "the AI couldn't find anything." It's the duplicate-page case, where three overlapping versions of a policy exist and the model confidently picks the wrong one. Someone on Hacker News caught Rovo doing the pure version of this on Confluence content, inventing an expansion for an acronym that was just a word someone had typed in capitals.

None of that is Claude's fault, and swapping models won't fix it. It's why my guide to Confluence knowledge integration spends more time on curation than on connectors, and why teams comparing Confluence alternatives often find the migration doesn't fix it either. The rot follows you. The same holds if you're weighing Confluence vs SharePoint or wiring pages through n8n.

Rovo or Claude: which should read your Confluence?

Rovo if you ask occasional questions inside Confluence; Claude if you do sustained work over many pages. Atlassian's own AI lives inside Confluence and needs no setup, so it's the obvious comparison. The real difference is the meter.

The credit arithmetic is where this gets concrete. A Rovo Chat quick answer or a basic agent run costs 10 credits. Think Deeper, advanced agents and Create with Rovo use a variable number. So a Confluence Premium seat adds 70 credits a month to the pool, about seven quick answers' worth. Search, summaries, chart insights and definitions are free and don't touch the meter, which is a real point in Rovo's favour for casual use.

Two fairness notes. Going over is now a billing question. Extra usage is on by default at $0.01 per credit ($10 per 1,000), and Atlassian says extra-usage billing takes effect on 3 December 2026. Admins can set a spending cap or turn extra usage off, in which case credit features pause until the monthly reset, and they get alerts at 80% and 100%. Usage already shows in Atlassian Administration, per app and per user. And Rovo's connector list is broad, covering Google Drive, Slack, SharePoint, GitHub, and around 40 other third-party sources. If neither fits, I've compared the field in Rovo alternatives.

My read: if you live in Confluence all day and ask it occasional questions, Rovo is fine and cheap enough. If you're doing sustained work over many pages, Claude through MCP is the better instrument, because plain page reads don't come with a per-question meter making you hesitate. I go deeper in Confluence search AI and Confluence AI copilot, with the setup walkthrough in Confluence copilot.

What does this actually cost?

The connector is free to connect. Everything under it isn't. Confluence Cloud prices on a progressive per-user ladder, so the per-seat number falls as you add people. These are the monthly list prices from Atlassian's licensing page.

Two things in that table catch people out. The Free plan has no space or page permissions at all, which makes it a poor place to test anything AI-related, since the permission scoping that makes MCP access safe simply doesn't exist. And Rovo needs a verified business domain, so an org on a consumer email domain cannot turn it on.

There's a deadline worth diarising too: Confluence Data Center goes read-only on 28 March 2029. For a fuller breakdown, see my write-ups on Confluence pricing and Confluence AI pricing, and the Jira pricing guide if you're buying both.

When is a chat window the wrong place for the answer?

When the person who needs the answer isn't the person typing into Claude. Everything above assumes they are. That covers a lot of real work: an engineer reconstructing a decision, a PM turning a spec into tickets, a new hire trying to find the deployment runbook.

It does not cover the case I spend most of my time on, which is somebody outside your company asking a question your Confluence already answers.

The tools are all pull, all 65 of them. A person prompts, Claude fetches, the answer lands in the chat. Nothing in the set watches an inbox, reads an incoming ticket, or sends a reply. That's not an oversight in Atlassian's design; it's what an MCP server is for.

The second problem is that a wiki only holds half the answer. A customer asking where their order is needs the shipping policy and the order record. A new starter asking about their leave balance needs the policy and their own accrual. Confluence has the first and none of the second, which is why a support answer assembled from documentation alone tends to be correct and useless at the same time. My post on Confluence agentic AI works through what closing that gap involves, and finding a Confluence agent covers the shortlist.

If the reader you're serving is internal and technical, stop here. Atlassian's MCP server plus Claude is a good setup and I'd use it. If the reader is a customer or an employee raising a request, you need something on the other side of the queue.

eesel AI for Confluence

I have a longer history with this problem than most, and not a flattering one to start with. eesel's first real growth engine was an Atlassian Marketplace app called ChatGPT for Confluence. People installed it from the marketplace with no credit card step and just kept paying, which taught me early that the demand isn't for a better wiki search box. It's for the wiki to stop being something you have to go and read.

So eesel works from the other end. It's an AI agent for Confluence that reads your Confluence Cloud live while it answers: it searches across spaces or within one, opens the page, and walks child pages. Nothing is copied into eesel, so it always works from the current version and links the page it used. Then it answers where the question was asked: your helpdesk, including Jira Service Management ticket replies, Slack, Microsoft Teams, a chat bubble or email. Nobody has to open Claude.

Here's what follows directly from the limits above:

• It watches the queue, which MCP doesn't. It runs when a ticket or message arrives. If the answer turns into work, the same agent files, assigns, labels and transitions issues through the AI agent for Jira.
• It reads Confluence and never writes to it. The page-blanking story above can't happen, because eesel has no Confluence write tools. It connects with one Atlassian API token and sees only what that one account can open, so pick the account with care. That is a different model from MCP, where each person signs in as themselves.
• You test it on real questions before it goes live. I've watched a confident-sounding bot quietly hand out wrong answers from a stale page, which is exactly the duplicate-page failure this post describes. Actions need approval until you trust them.
• It's Cloud first. Self-serve setup is Confluence Cloud. For some Data Center teams we run the sync as a managed setup, so get in touch if you're self-managed rather than assuming it works out of the box.
• Pricing is one fixed monthly price, from $299/month for 500 credits, where 1 credit is one ticket or chat however long it runs. No per-seat fee, and every integration is included. You can try it free with 100 credits, no card required, and the pricing page has the larger plans.

A development director at an EU HR-compliance company, running exactly this setup on Confluence and Slack, put the requirement plainly:

"We needed a turnkey solution for Confluence that met our GDPR requirements and could serve different teams through dedicated Slack bots. eesel AI delivered exactly that, with EU data residency included."

A chief innovation officer at a payments company, also on Confluence, reported up to 80% time savings on finding answers and onboarding new staff. Those are the two shapes this usually takes: compliance-shaped, or speed-shaped.

If you want the Claude-side version of this comparison for other tools, I've written up Claude for Jira Service Management, a broader look at Atlassian AI, and the Confluence roadmap assistant piece. And if you're weighing the wiki itself rather than the AI on top, Confluence vs Notion and my Confluence review are the places to start.